---
title: "Update a legal entity"
method: PATCH
path: "/legalEntities/{id}"
tags: ["Legal entities"]
---

# Update a legal entity

`PATCH /legalEntities/{id}`

Updates a legal entity.

 >To change the legal entity type, include only the new `type` in your request.

If you need to update information for the legal entity, make a separate request. To update the `entityAssociations` array, you need to replace the entire array.For example, if the array has 3 entries and you want to remove 1 entry, you need to PATCH the resource with the remaining 2 entries.

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.

## Path parameters

- `id` string, required

## Headers

- `x-requested-verification-code` string

## Request body

- LegalEntityInfo
  - `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' — 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/versions/2ae704e1705b/schema)