# legal\_entity\_company

From **Stripe API**.

- Type: `object`

## Properties

### `address`

- Required: false
- Type: `object`

### `address_kana`

- Required: false
- Nullable: true

The Kana variation of the company's primary address (Japan only).

### `address_kanji`

- Required: false
- Nullable: true

The Kanji variation of the company's primary address (Japan only).

### `directors_provided`

- Required: false
- Type: `boolean`

Whether the company's directors have been provided. This Boolean will be `true` if you've manually indicated that all directors are provided via [the `directors_provided` parameter](https://stripe.com/docs/api/accounts/update#update_account-company-directors_provided).

### `executives_provided`

- Required: false
- Type: `boolean`

Whether the company's executives have been provided. This Boolean will be `true` if you've manually indicated that all executives are provided via [the `executives_provided` parameter](https://stripe.com/docs/api/accounts/update#update_account-company-executives_provided), or if Stripe determined that sufficient executives were provided.

### `name`

- Required: false
- Type: `string`
- Nullable: true
- maxLength: `5000`

The company's legal name.

### `name_kana`

- Required: false
- Type: `string`
- Nullable: true
- maxLength: `5000`

The Kana variation of the company's legal name (Japan only).

### `name_kanji`

- Required: false
- Type: `string`
- Nullable: true
- maxLength: `5000`

The Kanji variation of the company's legal name (Japan only).

### `owners_provided`

- Required: false
- Type: `boolean`

Whether the company's owners have been provided. This Boolean will be `true` if you've manually indicated that all owners are provided via [the `owners_provided` parameter](https://stripe.com/docs/api/accounts/update#update_account-company-owners_provided), or if Stripe determined that sufficient owners were provided. Stripe determines ownership requirements using both the number of owners provided and their total percent ownership (calculated by adding the `percent_ownership` of each owner together).

### `ownership_declaration`

- Required: false
- Nullable: true

This hash is used to attest that the beneficial owner information provided to Stripe is both current and correct.

### `phone`

- Required: false
- Type: `string`
- Nullable: true
- maxLength: `5000`

The company's phone number (used for verification).

### `structure`

- Required: false
- Type: `string`
- Allowed values: `"free_zone_establishment"`, `"free_zone_llc"`, `"government_instrumentality"`, `"governmental_unit"`, `"incorporated_non_profit"`, `"limited_liability_partnership"`, `"llc"`, `"multi_member_llc"`, `"private_company"`, `"private_corporation"`, `"private_partnership"`, `"public_company"`, `"public_corporation"`, `"public_partnership"`, `"single_member_llc"`, `"sole_establishment"`, `"sole_proprietorship"`, `"tax_exempt_government_instrumentality"`, `"unincorporated_association"`, `"unincorporated_non_profit"`

The category identifying the legal structure of the company or legal entity. See [Business structure](https://stripe.com/docs/connect/identity-verification#business-structure) for more details.

### `tax_id_provided`

- Required: false
- Type: `boolean`

Whether the company's business ID number was provided.

### `tax_id_registrar`

- Required: false
- Type: `string`
- maxLength: `5000`

The jurisdiction in which the `tax_id` is registered (Germany-based companies only).

### `vat_id_provided`

- Required: false
- Type: `boolean`

Whether the company's business VAT number was provided.

### `verification`

- Required: false
- Nullable: true

Information on the verification state of the company.

## JSON Schema

```json
{"properties":{"address":{"$ref":"#/components/schemas/address"},"address_kana":{"anyOf":[{"$ref":"#/components/schemas/legal_entity_japan_address"}],"description":"The Kana variation of the company's primary address (Japan only).","nullable":true},"address_kanji":{"anyOf":[{"$ref":"#/components/schemas/legal_entity_japan_address"}],"description":"The Kanji variation of the company's primary address (Japan only).","nullable":true},"directors_provided":{"description":"Whether the company's directors have been provided. This Boolean will be `true` if you've manually indicated that all directors are provided via [the `directors_provided` parameter](https://stripe.com/docs/api/accounts/update#update_account-company-directors_provided).","type":"boolean"},"executives_provided":{"description":"Whether the company's executives have been provided. This Boolean will be `true` if you've manually indicated that all executives are provided via [the `executives_provided` parameter](https://stripe.com/docs/api/accounts/update#update_account-company-executives_provided), or if Stripe determined that sufficient executives were provided.","type":"boolean"},"name":{"description":"The company's legal name.","maxLength":5000,"nullable":true,"type":"string"},"name_kana":{"description":"The Kana variation of the company's legal name (Japan only).","maxLength":5000,"nullable":true,"type":"string"},"name_kanji":{"description":"The Kanji variation of the company's legal name (Japan only).","maxLength":5000,"nullable":true,"type":"string"},"owners_provided":{"description":"Whether the company's owners have been provided. This Boolean will be `true` if you've manually indicated that all owners are provided via [the `owners_provided` parameter](https://stripe.com/docs/api/accounts/update#update_account-company-owners_provided), or if Stripe determined that sufficient owners were provided. Stripe determines ownership requirements using both the number of owners provided and their total percent ownership (calculated by adding the `percent_ownership` of each owner together).","type":"boolean"},"ownership_declaration":{"anyOf":[{"$ref":"#/components/schemas/legal_entity_ubo_declaration"}],"description":"This hash is used to attest that the beneficial owner information provided to Stripe is both current and correct.","nullable":true},"phone":{"description":"The company's phone number (used for verification).","maxLength":5000,"nullable":true,"type":"string"},"structure":{"description":"The category identifying the legal structure of the company or legal entity. See [Business structure](https://stripe.com/docs/connect/identity-verification#business-structure) for more details.","enum":["free_zone_establishment","free_zone_llc","government_instrumentality","governmental_unit","incorporated_non_profit","limited_liability_partnership","llc","multi_member_llc","private_company","private_corporation","private_partnership","public_company","public_corporation","public_partnership","single_member_llc","sole_establishment","sole_proprietorship","tax_exempt_government_instrumentality","unincorporated_association","unincorporated_non_profit"],"type":"string","x-stripeBypassValidation":true},"tax_id_provided":{"description":"Whether the company's business ID number was provided.","type":"boolean"},"tax_id_registrar":{"description":"The jurisdiction in which the `tax_id` is registered (Germany-based companies only).","maxLength":5000,"type":"string"},"vat_id_provided":{"description":"Whether the company's business VAT number was provided.","type":"boolean"},"verification":{"anyOf":[{"$ref":"#/components/schemas/legal_entity_company_verification"}],"description":"Information on the verification state of the company.","nullable":true}},"title":"LegalEntityCompany","type":"object","x-expandableFields":["address","address_kana","address_kanji","ownership_declaration","verification"]}
```
