--- 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' | 'protector' | 'secondaryPartner' | 'secondaryTrustee' | 'settlor' | 'signatory' | 'trust' | 'uboThroughControl' | 'uboThroughOwnership' | 'undefinedBeneficiary', 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', required — Type of identity data. For individuals, the `type` value is **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 - `countryCode` string — The two-letter [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code. For example, **US** or **NL**. - `number` string, required — The phone number. - `type` string, required — 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. - `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 - `description` string — Your description for the organization. - `doingBusinessAs` string — The organization's trading name, if different from the registered legal name. - `email` string — The email address of the legal entity. - `legalName` string, required — The organization's legal name. - `phone` PhoneNumber - `countryCode` string — The two-letter [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code. For example, **US** or **NL**. - `number` string, required — The phone number. - `type` string, required — 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. - `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. - `taxExempt` boolean — Indicates whether the legal entity is exempt from tax. When **true**, the `taxIdAbsenceReason` must be provided. - `taxId` string — The organization's tax identifier. - `taxIdAbsenceReason` 'industryExemption' | 'belowTaxThreshold' — The reason the organization has not provided a tax identifier. Possible values: **industryExemption**, **belowTaxThreshold**. - `type` 'associationIncorporated' | 'governmentalOrganization' | 'listedPublicCompany' | 'nonProfit' | 'partnershipIncorporated' | 'privateCompany' — Type of organization. Possible values: **associationIncorporated**, **governmentalOrganization**, **listedPublicCompany**, **nonProfit**, **partnershipIncorporated**, **privateCompany**. - `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. - `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. - `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. - `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). - `vatAbsenceReason` 'industryExemption' | 'belowTaxThreshold' — The reason for not providing a VAT number. Possible values: **industryExemption**, **belowTaxThreshold**. - `vatNumber` string — The VAT number. - `type` 'individual' | 'organization' — The type of legal entity. Possible values: **individual** or **organization** - `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. - `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. - `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. - `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' | 'protector' | 'secondaryPartner' | 'secondaryTrustee' | 'settlor' | 'signatory' | 'trust' | 'uboThroughControl' | 'uboThroughOwnership' | 'undefinedBeneficiary', 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', required — Type of identity data. For individuals, the `type` value is **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 - `countryCode` string — The two-letter [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code. For example, **US** or **NL**. - `number` string, required — The phone number. - `type` string, required — 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. - `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 - `description` string — Your description for the organization. - `doingBusinessAs` string — The organization's trading name, if different from the registered legal name. - `email` string — The email address of the legal entity. - `legalName` string, required — The organization's legal name. - `phone` PhoneNumber - `countryCode` string — The two-letter [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code. For example, **US** or **NL**. - `number` string, required — The phone number. - `type` string, required — 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. - `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. - `taxExempt` boolean — Indicates whether the legal entity is exempt from tax. When **true**, the `taxIdAbsenceReason` must be provided. - `taxId` string — The organization's tax identifier. - `taxIdAbsenceReason` 'industryExemption' | 'belowTaxThreshold' — The reason the organization has not provided a tax identifier. Possible values: **industryExemption**, **belowTaxThreshold**. - `type` 'associationIncorporated' | 'governmentalOrganization' | 'listedPublicCompany' | 'nonProfit' | 'partnershipIncorporated' | 'privateCompany' — Type of organization. Possible values: **associationIncorporated**, **governmentalOrganization**, **listedPublicCompany**, **nonProfit**, **partnershipIncorporated**, **privateCompany**. - `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. - `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. - `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. - `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). - `vatAbsenceReason` 'industryExemption' | 'belowTaxThreshold' — The reason for not providing a VAT number. Possible values: **industryExemption**, **belowTaxThreshold**. - `vatNumber` string — The VAT number. - `type` 'individual' | 'organization' — The type of legal entity. Possible values: **individual** or **organization** - `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. - `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. - `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). ## 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/legalentityservice.md) · [All operations](https://skmtc.net/adyen/apis/legalentityservice/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/adyen/legalentityservice/versions/d0097ab4e2e8/schema)