--- title: "Create a legal entity" method: POST path: "/legalEntities" tags: ["Legal entities"] --- # Create a legal entity `POST /legalEntities` Creates a legal entity. This resource contains information about the user that will be onboarded in your platform. Adyen uses this information to perform verification checks as required by payment industry regulations. Adyen informs you of the verification results through webhooks or API responses. Requests to this endpoint are subject to rate limits: - Live environments: 700 requests per 5 seconds. - Test environments: 200 requests per 5 seconds. - Failed requests are subject to a limit of 5 failures per 10 seconds. ## Headers - `x-requested-verification-code` string ## Request body - LegalEntityInfoRequiredType - `capabilities` object — Contains key-value pairs that specify the actions that the legal entity can do in your platform.The key is a capability required for your integration. For example, **issueCard** for Issuing. The value is an object containing the settings for the capability. - `entityAssociations` LegalEntityAssociation[] — List of legal entities associated with the current legal entity. For example, ultimate beneficial owners associated with an organization through ownership or control, or as signatories. - `associatorId` string — The unique identifier of another legal entity with which the `legalEntityId` is associated. When the `legalEntityId` is associated to legal entities other than the current one, the response returns all the associations. - `entityType` string — The legal entity type of associated legal entity. For example, **organization**, **soleProprietorship** or **individual**. - `jobTitle` string — The individual's job title if the `type` is **uboThroughControl** or **signatory**. - `legalEntityId` string, required — The unique identifier of the associated [legal entity](https://docs.adyen.com/api-explorer/legalentity/latest/post/legalEntities#responses-200-id). - `name` string — The name of the associated [legal entity](https://docs.adyen.com/api-explorer/legalentity/latest/post/legalEntities#responses-200-id). - For **individual**, `name.firstName` and `name.lastName`. - For **organization**, `legalName`. - For **soleProprietorship**, `name`. - `nominee` boolean — Default value: **false** Set to **true** if the entity association `type` **director**, **secondaryPartner** or **shareholder** is also a nominee. Only applicable to New Zealand. - `relationship` string — The individual's relationship to a legal representative if the `type` is **legalRepresentative**. Possible values: **parent**, **guardian**. - `settlorExemptionReason` string[] — Defines the KYC exemption reason for a settlor associated with a trust. Only applicable to trusts in Australia. For example, **professionalServiceProvider**, **deceased**, or **contributionBelowThreshold**. - `type` 'definedBeneficiary' | 'director' | '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', required — 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)