Schema2020-08-27object

legal_entity_company

Source: openapi/spec3.json
Commit: d70de345383d
Active snapshot: da69df7e6e11

LegalEntityCompany

object

address Address object

optional

address_kana

optionalnullable

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

address_kanji

optionalnullable

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

directors_provided boolean

optional

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 boolean

optional

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 string

optionalnullable

The company's legal name.

maxLength:5000

name_kana string

optionalnullable

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

maxLength:5000

name_kanji string

optionalnullable

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

maxLength:5000

owners_provided boolean

optional

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

optionalnullable

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

phone string

optionalnullable

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

maxLength:5000

structure string

optional

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.

Allowed: "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"

tax_id_provided boolean

optional

Whether the company's business ID number was provided.

tax_id_registrar string

optional

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

maxLength:5000

vat_id_provided boolean

optional

Whether the company's business VAT number was provided.

verification

optionalnullable

Information on the verification state of the company.

Root JSON Schema

{"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"]}