---
title: "Create a legal entity"
method: POST
path: "/legalEntities"
tags: ["Legal entities"]
---

# Create a legal entity

`POST /legalEntities`

Creates a legal entity. 

This resource contains information about the user that will be onboarded in your platform. Adyen uses this information to perform verification checks as required by payment industry regulations. Adyen informs you of the verification results through webhooks or API responses.

Requests to this endpoint are subject to rate limits:

- Live environments: 700 requests per 5 seconds.

- Test environments: 200 requests per 5 seconds.

- Failed requests are subject to a limit of 5 failures per 10 seconds.

## Headers

- `x-requested-verification-code` string

## Request body

- LegalEntityInfoRequiredType
  - `capabilities` object — Contains key-value pairs that specify the actions that the legal entity can do in your platform.The key is a capability required for your integration. For example, **issueCard** for Issuing. The value is an object containing the settings for the capability.
  - `entityAssociations` LegalEntityAssociation[] — List of legal entities associated with the current legal entity. For example, ultimate beneficial owners associated with an organization through ownership or control, or as signatories.
    - `associatorId` string — The unique identifier of another legal entity with which the `legalEntityId` is associated. When the `legalEntityId` is associated to legal entities other than the current one, the response returns all the associations.
    - `entityType` string — The legal entity type of associated legal entity. For example, **organization**, **soleProprietorship** or **individual**.
    - `jobTitle` string — The individual's job title if the `type` is **uboThroughControl** or **signatory**.
    - `legalEntityId` string, required — The unique identifier of the associated [legal entity](https://docs.adyen.com/api-explorer/legalentity/latest/post/legalEntities#responses-200-id).
    - `name` string — The name of the associated [legal entity](https://docs.adyen.com/api-explorer/legalentity/latest/post/legalEntities#responses-200-id). - For **individual**, `name.firstName` and `name.lastName`. - For **organization**, `legalName`. - For **soleProprietorship**, `name`.
    - `nominee` boolean — Default value: **false** Set to **true** if the entity association `type` **director**, **secondaryPartner** or **shareholder** is also a nominee. Only applicable to New Zealand.
    - `relationship` string — The individual's relationship to a legal representative if the `type` is **legalRepresentative**. Possible values: **parent**, **guardian**.
    - `settlorExemptionReason` string[] — Defines the KYC exemption reason for a settlor associated with a trust. Only applicable to trusts in Australia. For example, **professionalServiceProvider**, **deceased**, or **contributionBelowThreshold**.
    - `type` 'definedBeneficiary' | 'director' | 'immediateParentCompany' | 'legalRepresentative' | 'pciSignatory' | 'protector' | 'secondaryPartner' | 'secondaryTrustee' | 'settlor' | 'signatory' | 'soleProprietorship' | 'trust' | 'trustOwnership' | 'uboThroughControl' | 'uboThroughOwnership' | 'ultimateParentCompany' | 'undefinedBeneficiary' | 'unincorporatedPartnership', required — Defines the relationship of the legal entity to the current legal entity. Possible value for individuals: **legalRepresentative**. Possible values for organizations: **director**, **signatory**, **trustOwnership**, **uboThroughOwnership**, **uboThroughControl**, **ultimateParentCompany**, or **immediateParentCompany**. Possible values for sole proprietorships: **soleProprietorship**. Possible value for trusts: **trust**. Possible values for trust members: **definedBeneficiary**, **protector**, **secondaryTrustee**, **settlor**, **uboThroughControl**, or **uboThroughOwnership**. Possible value for unincorporated partnership: **unincorporatedPartnership**. Possible values for unincorporated partnership members: **secondaryPartner**, **uboThroughControl**, **uboThroughOwnership**
  - `individual` Individual
    - `birthData` BirthData
      - `dateOfBirth` string — The individual's date of birth, in YYYY-MM-DD format.
    - `email` string — The email address of the legal entity.
    - `identificationData` IdentificationData
      - `cardNumber` string — The card number of the document that was issued (AU only).
      - `expiryDate` string — The expiry date of the document, in YYYY-MM-DD format.
      - `issuerCountry` string — The two-character [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code where the document was issued. For example, **US**.
      - `issuerState` string — The state or province where the document was issued (AU only).
      - `nationalIdExempt` boolean — Applies only to individuals in the US. Set to **true** if the individual does not have an SSN. To verify their identity, Adyen will require them to upload an ID document.
      - `number` string — The number in the document.
      - `type` 'nationalIdNumber' | 'passport' | 'driversLicense' | 'identityCard', required — Type of identity data. For individuals, the following types are supported. See our [onboarding guide](https://docs.adyen.com/platforms/onboard-users/onboarding-steps/?onboarding_type=custom) for other supported countries. - Australia: **driversLicense**, **passport** - Hong Kong: **driversLicense**, **nationalIdNumber**, **passport** - New Zealand: **driversLicense**, **passport** - Singapore: **driversLicense**, **nationalIdNumber**, **passport** - All other supported countries: **nationalIdNumber**
    - `name` Name, required
      - `firstName` string, required — The individual's first name. Must not be blank.
      - `infix` string — The infix in the individual's name, if any.
      - `lastName` string, required — The individual's last name. Must not be blank.
    - `nationality` string — The individual's nationality.
    - `phone` PhoneNumber
      - `number` string, required — The full phone number, including the country code. For example, **+3112345678**.
      - `phoneCountryCode` string — The two-letter [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code prefix of the phone number. For example, **US** or **NL**. The value of the `phoneCountryCode` is determined by the country code digit(s) of `phone.number`
      - `type` string — The type of phone number. Possible values: **mobile**, **landline**, **sip**, **fax.**
    - `residentialAddress` Address, required
      - `city` string — The name of the city. Required if `stateOrProvince` is provided. If you specify the city, you must also send `postalCode` and `street`.
      - `country` string, required — The two-letter [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code.
      - `postalCode` string — The postal code. Required if `stateOrProvince` and/or `city` is provided. When using alphanumeric postal codes, all letters must be uppercase. For example, 1234 AB or SW1A 1AA.
      - `stateOrProvince` string — The two-letter ISO 3166-2 state or province code. For example, **CA** in the US. Required for Australia and New Zealand. If you specify the state or province, you must also send `city`, `postalCode`, and `street`.
      - `street` string — The name of the street, and the house or building number. Required if `stateOrProvince` and/or `city` is provided.
      - `street2` string — The apartment, unit, or suite number.
    - `taxInformation` TaxInformation[] — The tax information of the individual.
      - `country` string — The two-letter [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code.
      - `number` string — The tax ID number (TIN) of the organization or individual.
      - `type` string — The TIN type depending on the country where it was issued. Only provide if the country has multiple tax IDs: Singapore, Sweden, the UK, or the US. For example, provide **SSN**, **EIN**, or **ITIN** for the US.
    - `webData` WebData
      - `webAddress` string — The URL of the website or the app store URL.
      - `webAddressId` string — The unique identifier of the web address.
  - `organization` Organization
    - `countryOfGoverningLaw` string — The two-character [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code of the governing country.
    - `dateOfIncorporation` string — The date when the organization was incorporated in YYYY-MM-DD format.
    - `dateOfInitiationOfLegalProceeding` string — Required if the value of `statusOfLegalProceeding` is one of the following: **underJudicialAdministration**, **bankruptcyInsolvency**, **otherLegalMeasures** The date at which a legal proceeding was initiated, in **YYYY-MM-DD** format. Example: **2000-02-12**
    - `description` string — Your description for the organization.
    - `doingBusinessAs` string — The organization's trading name, if different from the registered legal name.
    - `economicSector` string — The sector of the economy the legal entity operates within, represented by a 2-4 digit code that may include a ".". Example: 45.11 You can locate economic sector codes for your area by referencing codes defined by the NACE (Nomenclature of Economic Activities) used in the European Union.
    - `email` string — The email address of the legal entity.
    - `financialReports` FinancialReport[] — The financial report information of the organization.
      - `annualTurnover` string — The annual turnover of the business.
      - `balanceSheetTotal` string — The balance sheet total of the business.
      - `currencyOfFinancialData` string — The currency used for the annual turnover, balance sheet total, and net assets.
      - `dateOfFinancialData` string — The date the financial data were provided, in YYYY-MM-DD format.
      - `employeeCount` string — The number of employees of the business.
      - `netAssets` string — The net assets of the business.
    - `globalLegalEntityIdentifier` string — The global legal entity identifier for the organization. This field is not required if the `registrationNumber` for the organization has been provided.
    - `headOfficeIndicator` boolean — Indicates that the registered business address is also the company's headquarters.
    - `institutionalSector` 'nonFinancialCorporation' | 'centralBank' | 'creditInstitutions' | 'depositTakingCorporations' | 'moneyMarketFunds' | 'nonMMFInvestmentFunds' | 'financialVehicleCorporation' | 'otherFinancialIntermediaries' | 'financialAuxiliaries' | 'captiveFinancialInstitutionsAndMoneyLenders' | 'insuranceCorporations' | 'pensionFunds' | 'centralGovernment' | 'stateGovernment' | 'localGovernment' | 'socialSecurityFunds' | 'nonProfitInstitutionsServingHouseholds' — The institutional sector the organization operates within.
    - `legalForm` string — The type of business entity as defined in the national legal system. Use a legal form listed within the accepted legal forms compiled by the Central Bank of Europe.
    - `legalName` string, required — The organization's legal name.
    - `phone` PhoneNumber
      - `number` string, required — The full phone number, including the country code. For example, **+3112345678**.
      - `phoneCountryCode` string — The two-letter [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code prefix of the phone number. For example, **US** or **NL**. The value of the `phoneCountryCode` is determined by the country code digit(s) of `phone.number`
      - `type` string — The type of phone number. Possible values: **mobile**, **landline**, **sip**, **fax.**
    - `principalPlaceOfBusiness` Address
      - `city` string — The name of the city. Required if `stateOrProvince` is provided. If you specify the city, you must also send `postalCode` and `street`.
      - `country` string, required — The two-letter [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code.
      - `postalCode` string — The postal code. Required if `stateOrProvince` and/or `city` is provided. When using alphanumeric postal codes, all letters must be uppercase. For example, 1234 AB or SW1A 1AA.
      - `stateOrProvince` string — The two-letter ISO 3166-2 state or province code. For example, **CA** in the US. Required for Australia and New Zealand. If you specify the state or province, you must also send `city`, `postalCode`, and `street`.
      - `street` string — The name of the street, and the house or building number. Required if `stateOrProvince` and/or `city` is provided.
      - `street2` string — The apartment, unit, or suite number.
    - `registeredAddress` Address, required
      - `city` string — The name of the city. Required if `stateOrProvince` is provided. If you specify the city, you must also send `postalCode` and `street`.
      - `country` string, required — The two-letter [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code.
      - `postalCode` string — The postal code. Required if `stateOrProvince` and/or `city` is provided. When using alphanumeric postal codes, all letters must be uppercase. For example, 1234 AB or SW1A 1AA.
      - `stateOrProvince` string — The two-letter ISO 3166-2 state or province code. For example, **CA** in the US. Required for Australia and New Zealand. If you specify the state or province, you must also send `city`, `postalCode`, and `street`.
      - `street` string — The name of the street, and the house or building number. Required if `stateOrProvince` and/or `city` is provided.
      - `street2` string — The apartment, unit, or suite number.
    - `registrationNumber` string — The organization's registration number.
    - `statusOfLegalProceeding` 'noLegalActionsTaken' | 'underJudicialAdministration' | 'bankruptcyInsolvency' | 'otherLegalMeasures' — The status of any current or past legal action taken against the legal entity. Possible values: **noLegalActionsTaken**, **underJudicialAdministration**, **bankruptcyInsolvency**, **otherLegalMeasures** If the value of this field is **noLegalActionsTaken**, then `dateOfInitiationOfLegalProceeding` is not required. Otherwise, it is required.
    - `stockData` StockData
      - `marketIdentifier` string — The four-digit [Market Identifier Code](https://en.wikipedia.org/wiki/Market_Identifier_Code) of the stock market where the organization's stocks are traded.
      - `stockNumber` string — The 12-digit International Securities Identification Number (ISIN) of the company, without dashes (-).
      - `tickerSymbol` string — The stock ticker symbol.
    - `taxInformation` TaxInformation[] — The tax information of the organization.
      - `country` string — The two-letter [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code.
      - `number` string — The tax ID number (TIN) of the organization or individual.
      - `type` string — The TIN type depending on the country where it was issued. Only provide if the country has multiple tax IDs: Singapore, Sweden, the UK, or the US. For example, provide **SSN**, **EIN**, or **ITIN** for the US.
    - `taxReportingClassification` TaxReportingClassification
      - `businessType` 'other' | 'listedPublicCompany' | 'subsidiaryOfListedPublicCompany' | 'governmentalOrganization' | 'internationalOrganization' | 'financialInstitution' — The organization's business type. Possible values: **other**, **listedPublicCompany**, **subsidiaryOfListedPublicCompany**, **governmentalOrganization**, **internationalOrganization**, **financialInstitution**.
      - `financialInstitutionNumber` string — The Global Intermediary Identification Number (GIIN) required for FATCA. Only required if the organization is a US financial institution and the `businessType` is **financialInstitution**.
      - `mainSourceOfIncome` 'businessOperation' | 'realEstateSales' | 'investmentInterestOrRoyalty' | 'propertyRental' | 'other' — The organization's main source of income. Only required if `businessType` is **other**. Possible values: **businessOperation**, **realEstateSales**, **investmentInterestOrRoyalty**, **propertyRental**, **other**.
      - `type` 'nonFinancialNonReportable' | 'financialNonReportable' | 'nonFinancialActive' | 'nonFinancialPassive' — The tax reporting classification type. Possible values: **nonFinancialNonReportable**, **financialNonReportable**, **nonFinancialActive**, **nonFinancialPassive**.
    - `type` 'associationIncorporated' | 'governmentalOrganization' | 'listedPublicCompany' | 'nonProfit' | 'partnershipIncorporated' | 'privateCompany' — Type of organization. Possible values: **associationIncorporated**, **governmentalOrganization**, **listedPublicCompany**, **nonProfit**, **partnershipIncorporated**, **privateCompany**.
    - `vatAbsenceReason` 'industryExemption' | 'belowTaxThreshold' — The reason the organization has not provided a VAT number. Possible values: **industryExemption**, **belowTaxThreshold**.
    - `vatNumber` string — The organization's VAT number.
    - `webData` WebData
      - `webAddress` string — The URL of the website or the app store URL.
      - `webAddressId` string — The unique identifier of the web address.
  - `reference` string — Your reference for the legal entity, maximum 150 characters.
  - `soleProprietorship` SoleProprietorship
    - `countryOfGoverningLaw` string, required — The two-character [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code of the governing country.
    - `dateOfIncorporation` string — The date when the legal arrangement was incorporated in YYYY-MM-DD format.
    - `doingBusinessAs` string — The registered name, if different from the `name`.
    - `financialReports` FinancialReport[] — The information from the financial report of the sole proprietorship.
      - `annualTurnover` string — The annual turnover of the business.
      - `balanceSheetTotal` string — The balance sheet total of the business.
      - `currencyOfFinancialData` string — The currency used for the annual turnover, balance sheet total, and net assets.
      - `dateOfFinancialData` string — The date the financial data were provided, in YYYY-MM-DD format.
      - `employeeCount` string — The number of employees of the business.
      - `netAssets` string — The net assets of the business.
    - `name` string, required — The legal name.
    - `principalPlaceOfBusiness` Address
      - `city` string — The name of the city. Required if `stateOrProvince` is provided. If you specify the city, you must also send `postalCode` and `street`.
      - `country` string, required — The two-letter [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code.
      - `postalCode` string — The postal code. Required if `stateOrProvince` and/or `city` is provided. When using alphanumeric postal codes, all letters must be uppercase. For example, 1234 AB or SW1A 1AA.
      - `stateOrProvince` string — The two-letter ISO 3166-2 state or province code. For example, **CA** in the US. Required for Australia and New Zealand. If you specify the state or province, you must also send `city`, `postalCode`, and `street`.
      - `street` string — The name of the street, and the house or building number. Required if `stateOrProvince` and/or `city` is provided.
      - `street2` string — The apartment, unit, or suite number.
    - `registeredAddress` Address, required
      - `city` string — The name of the city. Required if `stateOrProvince` is provided. If you specify the city, you must also send `postalCode` and `street`.
      - `country` string, required — The two-letter [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code.
      - `postalCode` string — The postal code. Required if `stateOrProvince` and/or `city` is provided. When using alphanumeric postal codes, all letters must be uppercase. For example, 1234 AB or SW1A 1AA.
      - `stateOrProvince` string — The two-letter ISO 3166-2 state or province code. For example, **CA** in the US. Required for Australia and New Zealand. If you specify the state or province, you must also send `city`, `postalCode`, and `street`.
      - `street` string — The name of the street, and the house or building number. Required if `stateOrProvince` and/or `city` is provided.
      - `street2` string — The apartment, unit, or suite number.
    - `registrationNumber` string — The registration number.
    - `taxAbsent` boolean, nullable — The tax information is absent.
    - `taxInformation` TaxInformation[] — The tax information of the entity.
      - `country` string — The two-letter [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code.
      - `number` string — The tax ID number (TIN) of the organization or individual.
      - `type` string — The TIN type depending on the country where it was issued. Only provide if the country has multiple tax IDs: Singapore, Sweden, the UK, or the US. For example, provide **SSN**, **EIN**, or **ITIN** for the US.
    - `vatAbsenceReason` 'industryExemption' | 'belowTaxThreshold' — The reason for not providing a VAT number. Possible values: **industryExemption**, **belowTaxThreshold**.
    - `vatNumber` string — The VAT number.
  - `trust` Trust
    - `countryOfGoverningLaw` string, required — The two-character [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code of the governing country.
    - `dateOfIncorporation` string — The date when the legal arrangement was incorporated in YYYY-MM-DD format.
    - `description` string — A short description about the trust. Only applicable for charitable trusts in New Zealand.
    - `doingBusinessAs` string — The registered name, if different from the `name`.
    - `name` string, required — The legal name.
    - `principalPlaceOfBusiness` Address
      - `city` string — The name of the city. Required if `stateOrProvince` is provided. If you specify the city, you must also send `postalCode` and `street`.
      - `country` string, required — The two-letter [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code.
      - `postalCode` string — The postal code. Required if `stateOrProvince` and/or `city` is provided. When using alphanumeric postal codes, all letters must be uppercase. For example, 1234 AB or SW1A 1AA.
      - `stateOrProvince` string — The two-letter ISO 3166-2 state or province code. For example, **CA** in the US. Required for Australia and New Zealand. If you specify the state or province, you must also send `city`, `postalCode`, and `street`.
      - `street` string — The name of the street, and the house or building number. Required if `stateOrProvince` and/or `city` is provided.
      - `street2` string — The apartment, unit, or suite number.
    - `registeredAddress` Address, required
      - `city` string — The name of the city. Required if `stateOrProvince` is provided. If you specify the city, you must also send `postalCode` and `street`.
      - `country` string, required — The two-letter [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code.
      - `postalCode` string — The postal code. Required if `stateOrProvince` and/or `city` is provided. When using alphanumeric postal codes, all letters must be uppercase. For example, 1234 AB or SW1A 1AA.
      - `stateOrProvince` string — The two-letter ISO 3166-2 state or province code. For example, **CA** in the US. Required for Australia and New Zealand. If you specify the state or province, you must also send `city`, `postalCode`, and `street`.
      - `street` string — The name of the street, and the house or building number. Required if `stateOrProvince` and/or `city` is provided.
      - `street2` string — The apartment, unit, or suite number.
    - `registrationNumber` string — The registration number.
    - `taxInformation` TaxInformation[] — The tax information of the entity.
      - `country` string — The two-letter [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code.
      - `number` string — The tax ID number (TIN) of the organization or individual.
      - `type` string — The TIN type depending on the country where it was issued. Only provide if the country has multiple tax IDs: Singapore, Sweden, the UK, or the US. For example, provide **SSN**, **EIN**, or **ITIN** for the US.
    - `type` 'businessTrust' | 'cashManagementTrust' | 'charitableTrust' | 'corporateUnitTrust' | 'deceasedEstate' | 'discretionaryTrust' | 'discretionaryInvestmentTrust' | 'discretionaryServicesManagementTrust' | 'discretionaryTradingTrust' | 'familyTrust' | 'firstHomeSaverAccountsTrust' | 'fixedTrust' | 'fixedUnitTrust' | 'hybridTrust' | 'listedPublicUnitTrust' | 'otherTrust' | 'pooledSuperannuationTrust' | 'publicTradingTrust' | 'unlistedPublicUnitTrust', required — Type of trust. See possible values for trusts in [Australia](https://docs.adyen.com/platforms/verification-requirements/?tab=trust_3_4#trust-types-in-australia) and [New Zealand](https://docs.adyen.com/platforms/verification-requirements/?tab=trust_3_4#trust-types-in-new-zealand).
    - `undefinedBeneficiaryInfo` UndefinedBeneficiary[] — The undefined beneficiary information of the entity.
      - `description` string — The details of the undefined beneficiary.
      - `reference` string — The reference of the undefined beneficiary.
    - `vatAbsenceReason` 'industryExemption' | 'belowTaxThreshold' — The reason for not providing a VAT number. Possible values: **industryExemption**, **belowTaxThreshold**.
    - `vatNumber` string — The VAT number.
  - `type` 'individual' | 'organization' | 'soleProprietorship' | 'trust' | 'unincorporatedPartnership', required — The type of legal entity. Possible values: **individual**, **organization**, **soleProprietorship**, or **trust**.
  - `unincorporatedPartnership` UnincorporatedPartnership
    - `countryOfGoverningLaw` string, required — The two-character [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code of the governing country.
    - `dateOfIncorporation` string — The date when the legal arrangement was incorporated in YYYY-MM-DD format.
    - `description` string — Short description about the Legal Arrangement.
    - `doingBusinessAs` string — The registered name, if different from the `name`.
    - `name` string, required — The legal name.
    - `principalPlaceOfBusiness` Address
      - `city` string — The name of the city. Required if `stateOrProvince` is provided. If you specify the city, you must also send `postalCode` and `street`.
      - `country` string, required — The two-letter [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code.
      - `postalCode` string — The postal code. Required if `stateOrProvince` and/or `city` is provided. When using alphanumeric postal codes, all letters must be uppercase. For example, 1234 AB or SW1A 1AA.
      - `stateOrProvince` string — The two-letter ISO 3166-2 state or province code. For example, **CA** in the US. Required for Australia and New Zealand. If you specify the state or province, you must also send `city`, `postalCode`, and `street`.
      - `street` string — The name of the street, and the house or building number. Required if `stateOrProvince` and/or `city` is provided.
      - `street2` string — The apartment, unit, or suite number.
    - `registeredAddress` Address, required
      - `city` string — The name of the city. Required if `stateOrProvince` is provided. If you specify the city, you must also send `postalCode` and `street`.
      - `country` string, required — The two-letter [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code.
      - `postalCode` string — The postal code. Required if `stateOrProvince` and/or `city` is provided. When using alphanumeric postal codes, all letters must be uppercase. For example, 1234 AB or SW1A 1AA.
      - `stateOrProvince` string — The two-letter ISO 3166-2 state or province code. For example, **CA** in the US. Required for Australia and New Zealand. If you specify the state or province, you must also send `city`, `postalCode`, and `street`.
      - `street` string — The name of the street, and the house or building number. Required if `stateOrProvince` and/or `city` is provided.
      - `street2` string — The apartment, unit, or suite number.
    - `registrationNumber` string — The registration number.
    - `taxInformation` TaxInformation[] — The tax information of the entity.
      - `country` string — The two-letter [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code.
      - `number` string — The tax ID number (TIN) of the organization or individual.
      - `type` string — The TIN type depending on the country where it was issued. Only provide if the country has multiple tax IDs: Singapore, Sweden, the UK, or the US. For example, provide **SSN**, **EIN**, or **ITIN** for the US.
    - `type` 'limitedPartnership' | 'generalPartnership' | 'familyPartnership' | 'commercialPartnership' | 'publicPartnership' | 'otherPartnership' | 'gbr' | 'gmbh' | 'kgaa' | 'cv' | 'vof' | 'maatschap' | 'privateFundLimitedPartnership' | 'businessTrustEntity' | 'businessPartnership' | 'limitedLiabilityPartnership' | 'eg' | 'cooperative' | 'vos' | 'comunidadDeBienes' | 'herenciaYacente' | 'comunidadDePropietarios' | 'sep' | 'sca' | 'bt' | 'kkt' | 'scs' | 'snc' — Type of Partnership. Possible values: * **limitedPartnership** * **generalPartnership** * **familyPartnership** * **commercialPartnership** * **publicPartnership** * **otherPartnership** * **gbr** * **gmbh** * **kgaa** * **cv** * **vof** * **maatschap** * **privateFundLimitedPartnership** * **businessTrustEntity** * **businessPartnership** * **limitedLiabilityPartnership** * **eg** * **cooperative** * **vos** * **comunidadDeBienes** * **herenciaYacente** * **comunidadDePropietarios** * **sep** * **sca** * **bt** * **kkt** * **scs** * **snc**
    - `vatAbsenceReason` 'industryExemption' | 'belowTaxThreshold' — The reason for not providing a VAT number. Possible values: **industryExemption**, **belowTaxThreshold**.
    - `vatNumber` string — The VAT number.
  - `verificationPlan` string — A key-value pair that specifies the verification process for a legal entity. Set to **upfront** for upfront verification for [marketplaces](https://docs.adyen.com/marketplaces/verification-overview/verification-types/#upfront-verification).

## Response `200`

OK - the request has succeeded.

- LegalEntity
  - `capabilities` object — Contains key-value pairs that specify the actions that the legal entity can do in your platform.The key is a capability required for your integration. For example, **issueCard** for Issuing. The value is an object containing the settings for the capability.
  - `documentDetails` DocumentReference[] — List of documents uploaded for the legal entity.
    - `active` boolean — Identifies whether the document is active and used for checks.
    - `description` string — Your description for the document.
    - `fileName` string — Document name.
    - `id` string — The unique identifier of the resource.
    - `modificationDate` string, date-time — The modification date of the document.
    - `pages` DocumentPage[] — List of document pages
      - `pageName` string
      - `pageNumber` integer
      - `type` 'BACK' | 'FRONT' | 'UNDEFINED'
    - `type` string — Type of document, used when providing an ID number or uploading a document.
  - `documents` EntityReference[] — List of documents uploaded for the legal entity.
    - `id` string — The unique identifier of the resource.
  - `entityAssociations` LegalEntityAssociation[] — List of legal entities associated with the current legal entity. For example, ultimate beneficial owners associated with an organization through ownership or control, or as signatories.
    - `associatorId` string — The unique identifier of another legal entity with which the `legalEntityId` is associated. When the `legalEntityId` is associated to legal entities other than the current one, the response returns all the associations.
    - `entityType` string — The legal entity type of associated legal entity. For example, **organization**, **soleProprietorship** or **individual**.
    - `jobTitle` string — The individual's job title if the `type` is **uboThroughControl** or **signatory**.
    - `legalEntityId` string, required — The unique identifier of the associated [legal entity](https://docs.adyen.com/api-explorer/legalentity/latest/post/legalEntities#responses-200-id).
    - `name` string — The name of the associated [legal entity](https://docs.adyen.com/api-explorer/legalentity/latest/post/legalEntities#responses-200-id). - For **individual**, `name.firstName` and `name.lastName`. - For **organization**, `legalName`. - For **soleProprietorship**, `name`.
    - `nominee` boolean — Default value: **false** Set to **true** if the entity association `type` **director**, **secondaryPartner** or **shareholder** is also a nominee. Only applicable to New Zealand.
    - `relationship` string — The individual's relationship to a legal representative if the `type` is **legalRepresentative**. Possible values: **parent**, **guardian**.
    - `settlorExemptionReason` string[] — Defines the KYC exemption reason for a settlor associated with a trust. Only applicable to trusts in Australia. For example, **professionalServiceProvider**, **deceased**, or **contributionBelowThreshold**.
    - `type` 'definedBeneficiary' | 'director' | 'immediateParentCompany' | 'legalRepresentative' | 'pciSignatory' | 'protector' | 'secondaryPartner' | 'secondaryTrustee' | 'settlor' | 'signatory' | 'soleProprietorship' | 'trust' | 'trustOwnership' | 'uboThroughControl' | 'uboThroughOwnership' | 'ultimateParentCompany' | 'undefinedBeneficiary' | 'unincorporatedPartnership', required — Defines the relationship of the legal entity to the current legal entity. Possible value for individuals: **legalRepresentative**. Possible values for organizations: **director**, **signatory**, **trustOwnership**, **uboThroughOwnership**, **uboThroughControl**, **ultimateParentCompany**, or **immediateParentCompany**. Possible values for sole proprietorships: **soleProprietorship**. Possible value for trusts: **trust**. Possible values for trust members: **definedBeneficiary**, **protector**, **secondaryTrustee**, **settlor**, **uboThroughControl**, or **uboThroughOwnership**. Possible value for unincorporated partnership: **unincorporatedPartnership**. Possible values for unincorporated partnership members: **secondaryPartner**, **uboThroughControl**, **uboThroughOwnership**
  - `id` string, required — The unique identifier of the legal entity.
  - `individual` Individual
    - `birthData` BirthData
      - `dateOfBirth` string — The individual's date of birth, in YYYY-MM-DD format.
    - `email` string — The email address of the legal entity.
    - `identificationData` IdentificationData
      - `cardNumber` string — The card number of the document that was issued (AU only).
      - `expiryDate` string — The expiry date of the document, in YYYY-MM-DD format.
      - `issuerCountry` string — The two-character [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code where the document was issued. For example, **US**.
      - `issuerState` string — The state or province where the document was issued (AU only).
      - `nationalIdExempt` boolean — Applies only to individuals in the US. Set to **true** if the individual does not have an SSN. To verify their identity, Adyen will require them to upload an ID document.
      - `number` string — The number in the document.
      - `type` 'nationalIdNumber' | 'passport' | 'driversLicense' | 'identityCard', required — Type of identity data. For individuals, the following types are supported. See our [onboarding guide](https://docs.adyen.com/platforms/onboard-users/onboarding-steps/?onboarding_type=custom) for other supported countries. - Australia: **driversLicense**, **passport** - Hong Kong: **driversLicense**, **nationalIdNumber**, **passport** - New Zealand: **driversLicense**, **passport** - Singapore: **driversLicense**, **nationalIdNumber**, **passport** - All other supported countries: **nationalIdNumber**
    - `name` Name, required
      - `firstName` string, required — The individual's first name. Must not be blank.
      - `infix` string — The infix in the individual's name, if any.
      - `lastName` string, required — The individual's last name. Must not be blank.
    - `nationality` string — The individual's nationality.
    - `phone` PhoneNumber
      - `number` string, required — The full phone number, including the country code. For example, **+3112345678**.
      - `phoneCountryCode` string — The two-letter [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code prefix of the phone number. For example, **US** or **NL**. The value of the `phoneCountryCode` is determined by the country code digit(s) of `phone.number`
      - `type` string — The type of phone number. Possible values: **mobile**, **landline**, **sip**, **fax.**
    - `residentialAddress` Address, required
      - `city` string — The name of the city. Required if `stateOrProvince` is provided. If you specify the city, you must also send `postalCode` and `street`.
      - `country` string, required — The two-letter [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code.
      - `postalCode` string — The postal code. Required if `stateOrProvince` and/or `city` is provided. When using alphanumeric postal codes, all letters must be uppercase. For example, 1234 AB or SW1A 1AA.
      - `stateOrProvince` string — The two-letter ISO 3166-2 state or province code. For example, **CA** in the US. Required for Australia and New Zealand. If you specify the state or province, you must also send `city`, `postalCode`, and `street`.
      - `street` string — The name of the street, and the house or building number. Required if `stateOrProvince` and/or `city` is provided.
      - `street2` string — The apartment, unit, or suite number.
    - `taxInformation` TaxInformation[] — The tax information of the individual.
      - `country` string — The two-letter [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code.
      - `number` string — The tax ID number (TIN) of the organization or individual.
      - `type` string — The TIN type depending on the country where it was issued. Only provide if the country has multiple tax IDs: Singapore, Sweden, the UK, or the US. For example, provide **SSN**, **EIN**, or **ITIN** for the US.
    - `webData` WebData
      - `webAddress` string — The URL of the website or the app store URL.
      - `webAddressId` string — The unique identifier of the web address.
  - `organization` Organization
    - `countryOfGoverningLaw` string — The two-character [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code of the governing country.
    - `dateOfIncorporation` string — The date when the organization was incorporated in YYYY-MM-DD format.
    - `dateOfInitiationOfLegalProceeding` string — Required if the value of `statusOfLegalProceeding` is one of the following: **underJudicialAdministration**, **bankruptcyInsolvency**, **otherLegalMeasures** The date at which a legal proceeding was initiated, in **YYYY-MM-DD** format. Example: **2000-02-12**
    - `description` string — Your description for the organization.
    - `doingBusinessAs` string — The organization's trading name, if different from the registered legal name.
    - `economicSector` string — The sector of the economy the legal entity operates within, represented by a 2-4 digit code that may include a ".". Example: 45.11 You can locate economic sector codes for your area by referencing codes defined by the NACE (Nomenclature of Economic Activities) used in the European Union.
    - `email` string — The email address of the legal entity.
    - `financialReports` FinancialReport[] — The financial report information of the organization.
      - `annualTurnover` string — The annual turnover of the business.
      - `balanceSheetTotal` string — The balance sheet total of the business.
      - `currencyOfFinancialData` string — The currency used for the annual turnover, balance sheet total, and net assets.
      - `dateOfFinancialData` string — The date the financial data were provided, in YYYY-MM-DD format.
      - `employeeCount` string — The number of employees of the business.
      - `netAssets` string — The net assets of the business.
    - `globalLegalEntityIdentifier` string — The global legal entity identifier for the organization. This field is not required if the `registrationNumber` for the organization has been provided.
    - `headOfficeIndicator` boolean — Indicates that the registered business address is also the company's headquarters.
    - `institutionalSector` 'nonFinancialCorporation' | 'centralBank' | 'creditInstitutions' | 'depositTakingCorporations' | 'moneyMarketFunds' | 'nonMMFInvestmentFunds' | 'financialVehicleCorporation' | 'otherFinancialIntermediaries' | 'financialAuxiliaries' | 'captiveFinancialInstitutionsAndMoneyLenders' | 'insuranceCorporations' | 'pensionFunds' | 'centralGovernment' | 'stateGovernment' | 'localGovernment' | 'socialSecurityFunds' | 'nonProfitInstitutionsServingHouseholds' — The institutional sector the organization operates within.
    - `legalForm` string — The type of business entity as defined in the national legal system. Use a legal form listed within the accepted legal forms compiled by the Central Bank of Europe.
    - `legalName` string, required — The organization's legal name.
    - `phone` PhoneNumber
      - `number` string, required — The full phone number, including the country code. For example, **+3112345678**.
      - `phoneCountryCode` string — The two-letter [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code prefix of the phone number. For example, **US** or **NL**. The value of the `phoneCountryCode` is determined by the country code digit(s) of `phone.number`
      - `type` string — The type of phone number. Possible values: **mobile**, **landline**, **sip**, **fax.**
    - `principalPlaceOfBusiness` Address
      - `city` string — The name of the city. Required if `stateOrProvince` is provided. If you specify the city, you must also send `postalCode` and `street`.
      - `country` string, required — The two-letter [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code.
      - `postalCode` string — The postal code. Required if `stateOrProvince` and/or `city` is provided. When using alphanumeric postal codes, all letters must be uppercase. For example, 1234 AB or SW1A 1AA.
      - `stateOrProvince` string — The two-letter ISO 3166-2 state or province code. For example, **CA** in the US. Required for Australia and New Zealand. If you specify the state or province, you must also send `city`, `postalCode`, and `street`.
      - `street` string — The name of the street, and the house or building number. Required if `stateOrProvince` and/or `city` is provided.
      - `street2` string — The apartment, unit, or suite number.
    - `registeredAddress` Address, required
      - `city` string — The name of the city. Required if `stateOrProvince` is provided. If you specify the city, you must also send `postalCode` and `street`.
      - `country` string, required — The two-letter [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code.
      - `postalCode` string — The postal code. Required if `stateOrProvince` and/or `city` is provided. When using alphanumeric postal codes, all letters must be uppercase. For example, 1234 AB or SW1A 1AA.
      - `stateOrProvince` string — The two-letter ISO 3166-2 state or province code. For example, **CA** in the US. Required for Australia and New Zealand. If you specify the state or province, you must also send `city`, `postalCode`, and `street`.
      - `street` string — The name of the street, and the house or building number. Required if `stateOrProvince` and/or `city` is provided.
      - `street2` string — The apartment, unit, or suite number.
    - `registrationNumber` string — The organization's registration number.
    - `statusOfLegalProceeding` 'noLegalActionsTaken' | 'underJudicialAdministration' | 'bankruptcyInsolvency' | 'otherLegalMeasures' — The status of any current or past legal action taken against the legal entity. Possible values: **noLegalActionsTaken**, **underJudicialAdministration**, **bankruptcyInsolvency**, **otherLegalMeasures** If the value of this field is **noLegalActionsTaken**, then `dateOfInitiationOfLegalProceeding` is not required. Otherwise, it is required.
    - `stockData` StockData
      - `marketIdentifier` string — The four-digit [Market Identifier Code](https://en.wikipedia.org/wiki/Market_Identifier_Code) of the stock market where the organization's stocks are traded.
      - `stockNumber` string — The 12-digit International Securities Identification Number (ISIN) of the company, without dashes (-).
      - `tickerSymbol` string — The stock ticker symbol.
    - `taxInformation` TaxInformation[] — The tax information of the organization.
      - `country` string — The two-letter [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code.
      - `number` string — The tax ID number (TIN) of the organization or individual.
      - `type` string — The TIN type depending on the country where it was issued. Only provide if the country has multiple tax IDs: Singapore, Sweden, the UK, or the US. For example, provide **SSN**, **EIN**, or **ITIN** for the US.
    - `taxReportingClassification` TaxReportingClassification
      - `businessType` 'other' | 'listedPublicCompany' | 'subsidiaryOfListedPublicCompany' | 'governmentalOrganization' | 'internationalOrganization' | 'financialInstitution' — The organization's business type. Possible values: **other**, **listedPublicCompany**, **subsidiaryOfListedPublicCompany**, **governmentalOrganization**, **internationalOrganization**, **financialInstitution**.
      - `financialInstitutionNumber` string — The Global Intermediary Identification Number (GIIN) required for FATCA. Only required if the organization is a US financial institution and the `businessType` is **financialInstitution**.
      - `mainSourceOfIncome` 'businessOperation' | 'realEstateSales' | 'investmentInterestOrRoyalty' | 'propertyRental' | 'other' — The organization's main source of income. Only required if `businessType` is **other**. Possible values: **businessOperation**, **realEstateSales**, **investmentInterestOrRoyalty**, **propertyRental**, **other**.
      - `type` 'nonFinancialNonReportable' | 'financialNonReportable' | 'nonFinancialActive' | 'nonFinancialPassive' — The tax reporting classification type. Possible values: **nonFinancialNonReportable**, **financialNonReportable**, **nonFinancialActive**, **nonFinancialPassive**.
    - `type` 'associationIncorporated' | 'governmentalOrganization' | 'listedPublicCompany' | 'nonProfit' | 'partnershipIncorporated' | 'privateCompany' — Type of organization. Possible values: **associationIncorporated**, **governmentalOrganization**, **listedPublicCompany**, **nonProfit**, **partnershipIncorporated**, **privateCompany**.
    - `vatAbsenceReason` 'industryExemption' | 'belowTaxThreshold' — The reason the organization has not provided a VAT number. Possible values: **industryExemption**, **belowTaxThreshold**.
    - `vatNumber` string — The organization's VAT number.
    - `webData` WebData
      - `webAddress` string — The URL of the website or the app store URL.
      - `webAddressId` string — The unique identifier of the web address.
  - `problems` CapabilityProblem[] — List of verification errors related to capabilities for the legal entity.
    - `entity` CapabilityProblemEntity
      - `documents` string[] — List of document IDs corresponding to the verification errors from capabilities.
      - `id` string
      - `owner` CapabilityProblemEntityRecursive
        - `documents` string[] — List of document IDs corresponding to the verification errors from capabilities.
        - `id` string
        - `type` 'BankAccount' | 'Document' | 'LegalEntity' | 'product'
      - `type` 'BankAccount' | 'Document' | 'LegalEntity' | 'product'
    - `verificationErrors` VerificationError[]
      - `capabilities` string[] — Contains key-value pairs that specify the actions that the legal entity can do in your platform. The key is a capability required for your integration. For example, **issueCard** for Issuing.The value is an object containing the settings for the capability.
      - `code` string — The general error code.
      - `message` string — The general error message.
      - `remediatingActions` RemediatingAction[] — An object containing possible solutions to fix a verification error.
        - `code` string
        - `message` string
      - `subErrors` VerificationErrorRecursive[] — An array containing more granular information about the cause of the verification error.
        - `capabilities` string[] — Contains key-value pairs that specify the actions that the legal entity can do in your platform. The key is a capability required for your integration. For example, **issueCard** for Issuing.The value is an object containing the settings for the capability.
        - `code` string — The general error code.
        - `message` string — The general error message.
        - `type` 'dataMissing' | 'dataReview' | 'invalidInput' | 'pendingStatus' | 'rejected' — The type of error. Possible values: * **invalidInput** * **dataMissing** * **pendingStatus** * **rejected** * **dataReview**
        - `remediatingActions` RemediatingAction[] — An object containing possible solutions to fix a verification error.
          - `code` string
          - `message` string
      - `type` 'dataMissing' | 'dataReview' | 'invalidInput' | 'pendingStatus' | 'rejected' — The type of error. Possible values: * **invalidInput** * **dataMissing** * **pendingStatus** * **rejected** * **dataReview**
  - `reference` string — Your reference for the legal entity, maximum 150 characters.
  - `soleProprietorship` SoleProprietorship
    - `countryOfGoverningLaw` string, required — The two-character [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code of the governing country.
    - `dateOfIncorporation` string — The date when the legal arrangement was incorporated in YYYY-MM-DD format.
    - `doingBusinessAs` string — The registered name, if different from the `name`.
    - `financialReports` FinancialReport[] — The information from the financial report of the sole proprietorship.
      - `annualTurnover` string — The annual turnover of the business.
      - `balanceSheetTotal` string — The balance sheet total of the business.
      - `currencyOfFinancialData` string — The currency used for the annual turnover, balance sheet total, and net assets.
      - `dateOfFinancialData` string — The date the financial data were provided, in YYYY-MM-DD format.
      - `employeeCount` string — The number of employees of the business.
      - `netAssets` string — The net assets of the business.
    - `name` string, required — The legal name.
    - `principalPlaceOfBusiness` Address
      - `city` string — The name of the city. Required if `stateOrProvince` is provided. If you specify the city, you must also send `postalCode` and `street`.
      - `country` string, required — The two-letter [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code.
      - `postalCode` string — The postal code. Required if `stateOrProvince` and/or `city` is provided. When using alphanumeric postal codes, all letters must be uppercase. For example, 1234 AB or SW1A 1AA.
      - `stateOrProvince` string — The two-letter ISO 3166-2 state or province code. For example, **CA** in the US. Required for Australia and New Zealand. If you specify the state or province, you must also send `city`, `postalCode`, and `street`.
      - `street` string — The name of the street, and the house or building number. Required if `stateOrProvince` and/or `city` is provided.
      - `street2` string — The apartment, unit, or suite number.
    - `registeredAddress` Address, required
      - `city` string — The name of the city. Required if `stateOrProvince` is provided. If you specify the city, you must also send `postalCode` and `street`.
      - `country` string, required — The two-letter [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code.
      - `postalCode` string — The postal code. Required if `stateOrProvince` and/or `city` is provided. When using alphanumeric postal codes, all letters must be uppercase. For example, 1234 AB or SW1A 1AA.
      - `stateOrProvince` string — The two-letter ISO 3166-2 state or province code. For example, **CA** in the US. Required for Australia and New Zealand. If you specify the state or province, you must also send `city`, `postalCode`, and `street`.
      - `street` string — The name of the street, and the house or building number. Required if `stateOrProvince` and/or `city` is provided.
      - `street2` string — The apartment, unit, or suite number.
    - `registrationNumber` string — The registration number.
    - `taxAbsent` boolean, nullable — The tax information is absent.
    - `taxInformation` TaxInformation[] — The tax information of the entity.
      - `country` string — The two-letter [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code.
      - `number` string — The tax ID number (TIN) of the organization or individual.
      - `type` string — The TIN type depending on the country where it was issued. Only provide if the country has multiple tax IDs: Singapore, Sweden, the UK, or the US. For example, provide **SSN**, **EIN**, or **ITIN** for the US.
    - `vatAbsenceReason` 'industryExemption' | 'belowTaxThreshold' — The reason for not providing a VAT number. Possible values: **industryExemption**, **belowTaxThreshold**.
    - `vatNumber` string — The VAT number.
  - `transferInstruments` TransferInstrumentReference[] — List of transfer instruments that the legal entity owns.
    - `accountIdentifier` string, required — The masked IBAN or bank account number.
    - `id` string, required — The unique identifier of the resource.
    - `realLastFour` string — Four last digits of the bank account number. If the transfer instrument is created using [instant bank account verification](https://docs.adyen.com/release-notes/platforms-and-financial-products#releaseNote=2023-05-08-hosted-onboarding), and it is a virtual bank account, these digits may be different from the last four digits of the masked account number.
    - `trustedSource` boolean — Identifies if the bank account was created through [instant bank verification](https://docs.adyen.com/release-notes/platforms-and-financial-products#releaseNote=2023-05-08-hosted-onboarding).
  - `trust` Trust
    - `countryOfGoverningLaw` string, required — The two-character [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code of the governing country.
    - `dateOfIncorporation` string — The date when the legal arrangement was incorporated in YYYY-MM-DD format.
    - `description` string — A short description about the trust. Only applicable for charitable trusts in New Zealand.
    - `doingBusinessAs` string — The registered name, if different from the `name`.
    - `name` string, required — The legal name.
    - `principalPlaceOfBusiness` Address
      - `city` string — The name of the city. Required if `stateOrProvince` is provided. If you specify the city, you must also send `postalCode` and `street`.
      - `country` string, required — The two-letter [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code.
      - `postalCode` string — The postal code. Required if `stateOrProvince` and/or `city` is provided. When using alphanumeric postal codes, all letters must be uppercase. For example, 1234 AB or SW1A 1AA.
      - `stateOrProvince` string — The two-letter ISO 3166-2 state or province code. For example, **CA** in the US. Required for Australia and New Zealand. If you specify the state or province, you must also send `city`, `postalCode`, and `street`.
      - `street` string — The name of the street, and the house or building number. Required if `stateOrProvince` and/or `city` is provided.
      - `street2` string — The apartment, unit, or suite number.
    - `registeredAddress` Address, required
      - `city` string — The name of the city. Required if `stateOrProvince` is provided. If you specify the city, you must also send `postalCode` and `street`.
      - `country` string, required — The two-letter [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code.
      - `postalCode` string — The postal code. Required if `stateOrProvince` and/or `city` is provided. When using alphanumeric postal codes, all letters must be uppercase. For example, 1234 AB or SW1A 1AA.
      - `stateOrProvince` string — The two-letter ISO 3166-2 state or province code. For example, **CA** in the US. Required for Australia and New Zealand. If you specify the state or province, you must also send `city`, `postalCode`, and `street`.
      - `street` string — The name of the street, and the house or building number. Required if `stateOrProvince` and/or `city` is provided.
      - `street2` string — The apartment, unit, or suite number.
    - `registrationNumber` string — The registration number.
    - `taxInformation` TaxInformation[] — The tax information of the entity.
      - `country` string — The two-letter [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code.
      - `number` string — The tax ID number (TIN) of the organization or individual.
      - `type` string — The TIN type depending on the country where it was issued. Only provide if the country has multiple tax IDs: Singapore, Sweden, the UK, or the US. For example, provide **SSN**, **EIN**, or **ITIN** for the US.
    - `type` 'businessTrust' | 'cashManagementTrust' | 'charitableTrust' | 'corporateUnitTrust' | 'deceasedEstate' | 'discretionaryTrust' | 'discretionaryInvestmentTrust' | 'discretionaryServicesManagementTrust' | 'discretionaryTradingTrust' | 'familyTrust' | 'firstHomeSaverAccountsTrust' | 'fixedTrust' | 'fixedUnitTrust' | 'hybridTrust' | 'listedPublicUnitTrust' | 'otherTrust' | 'pooledSuperannuationTrust' | 'publicTradingTrust' | 'unlistedPublicUnitTrust', required — Type of trust. See possible values for trusts in [Australia](https://docs.adyen.com/platforms/verification-requirements/?tab=trust_3_4#trust-types-in-australia) and [New Zealand](https://docs.adyen.com/platforms/verification-requirements/?tab=trust_3_4#trust-types-in-new-zealand).
    - `undefinedBeneficiaryInfo` UndefinedBeneficiary[] — The undefined beneficiary information of the entity.
      - `description` string — The details of the undefined beneficiary.
      - `reference` string — The reference of the undefined beneficiary.
    - `vatAbsenceReason` 'industryExemption' | 'belowTaxThreshold' — The reason for not providing a VAT number. Possible values: **industryExemption**, **belowTaxThreshold**.
    - `vatNumber` string — The VAT number.
  - `type` 'individual' | 'organization' | 'soleProprietorship' | 'trust' | 'unincorporatedPartnership' — The type of legal entity. Possible values: **individual**, **organization**, **soleProprietorship**, or **trust**.
  - `unincorporatedPartnership` UnincorporatedPartnership
    - `countryOfGoverningLaw` string, required — The two-character [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code of the governing country.
    - `dateOfIncorporation` string — The date when the legal arrangement was incorporated in YYYY-MM-DD format.
    - `description` string — Short description about the Legal Arrangement.
    - `doingBusinessAs` string — The registered name, if different from the `name`.
    - `name` string, required — The legal name.
    - `principalPlaceOfBusiness` Address
      - `city` string — The name of the city. Required if `stateOrProvince` is provided. If you specify the city, you must also send `postalCode` and `street`.
      - `country` string, required — The two-letter [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code.
      - `postalCode` string — The postal code. Required if `stateOrProvince` and/or `city` is provided. When using alphanumeric postal codes, all letters must be uppercase. For example, 1234 AB or SW1A 1AA.
      - `stateOrProvince` string — The two-letter ISO 3166-2 state or province code. For example, **CA** in the US. Required for Australia and New Zealand. If you specify the state or province, you must also send `city`, `postalCode`, and `street`.
      - `street` string — The name of the street, and the house or building number. Required if `stateOrProvince` and/or `city` is provided.
      - `street2` string — The apartment, unit, or suite number.
    - `registeredAddress` Address, required
      - `city` string — The name of the city. Required if `stateOrProvince` is provided. If you specify the city, you must also send `postalCode` and `street`.
      - `country` string, required — The two-letter [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code.
      - `postalCode` string — The postal code. Required if `stateOrProvince` and/or `city` is provided. When using alphanumeric postal codes, all letters must be uppercase. For example, 1234 AB or SW1A 1AA.
      - `stateOrProvince` string — The two-letter ISO 3166-2 state or province code. For example, **CA** in the US. Required for Australia and New Zealand. If you specify the state or province, you must also send `city`, `postalCode`, and `street`.
      - `street` string — The name of the street, and the house or building number. Required if `stateOrProvince` and/or `city` is provided.
      - `street2` string — The apartment, unit, or suite number.
    - `registrationNumber` string — The registration number.
    - `taxInformation` TaxInformation[] — The tax information of the entity.
      - `country` string — The two-letter [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code.
      - `number` string — The tax ID number (TIN) of the organization or individual.
      - `type` string — The TIN type depending on the country where it was issued. Only provide if the country has multiple tax IDs: Singapore, Sweden, the UK, or the US. For example, provide **SSN**, **EIN**, or **ITIN** for the US.
    - `type` 'limitedPartnership' | 'generalPartnership' | 'familyPartnership' | 'commercialPartnership' | 'publicPartnership' | 'otherPartnership' | 'gbr' | 'gmbh' | 'kgaa' | 'cv' | 'vof' | 'maatschap' | 'privateFundLimitedPartnership' | 'businessTrustEntity' | 'businessPartnership' | 'limitedLiabilityPartnership' | 'eg' | 'cooperative' | 'vos' | 'comunidadDeBienes' | 'herenciaYacente' | 'comunidadDePropietarios' | 'sep' | 'sca' | 'bt' | 'kkt' | 'scs' | 'snc' — Type of Partnership. Possible values: * **limitedPartnership** * **generalPartnership** * **familyPartnership** * **commercialPartnership** * **publicPartnership** * **otherPartnership** * **gbr** * **gmbh** * **kgaa** * **cv** * **vof** * **maatschap** * **privateFundLimitedPartnership** * **businessTrustEntity** * **businessPartnership** * **limitedLiabilityPartnership** * **eg** * **cooperative** * **vos** * **comunidadDeBienes** * **herenciaYacente** * **comunidadDePropietarios** * **sep** * **sca** * **bt** * **kkt** * **scs** * **snc**
    - `vatAbsenceReason` 'industryExemption' | 'belowTaxThreshold' — The reason for not providing a VAT number. Possible values: **industryExemption**, **belowTaxThreshold**.
    - `vatNumber` string — The VAT number.
  - `verificationDeadlines` VerificationDeadline[] — List of verification deadlines and the capabilities that will be disallowed if verification errors are not resolved.
    - `capabilities` string[], required — The list of capabilities that will be disallowed if information is not reviewed by the time of the deadline
    - `entityIds` string[] — The unique identifiers of the legal entity or supporting entities that the deadline applies to
    - `expiresAt` string, date-time, required — The date that verification is due by before capabilities are disallowed.
  - `verificationPlan` string — A key-value pair that specifies the verification process for a legal entity. Set to **upfront** for upfront verification for [marketplaces](https://docs.adyen.com/marketplaces/verification-overview/verification-types/#upfront-verification).

## Other responses

- `400` — Bad Request - a problem reading or understanding the request.
- `401` — Unauthorized - authentication required.
- `403` — Forbidden - insufficient permissions to process the request.
- `422` — Unprocessable Entity - a request validation error.
- `500` — Internal Server Error - the server could not process the request.

---

[API](https://skmtc.net/adyen/apis/legal-entity-management-api.md) · [All operations](https://skmtc.net/adyen/apis/legal-entity-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/adyen/legal-entity-management-api/revisions/2ae704e1705b/schema)