Get an account holder
Returns the details of an account holder.
Request Parameters
The code of the account of which to retrieve the details.
Required if no
accountHolderCode
is provided.
The code of the account holder of which to retrieve the details.
Required if no
accountCode
is provided.
True if the request should return the account holder details
Response parameters
After submitting a call, you receive a response message to inform you that your request was received and processed.
Depending on the HTTP status code of the response message, it is helpful to build some logic to handle any errors that a request or the system may return.
HTTP Responses
200 - OK
The request has succeeded.
Show moreShow lessaccountHolderCodestringThe code of the account holder.
accountHolderDetailsobjectDetails of the account holder.
addressobjectThe address of the account holder.
citystringThe name of the city. Required if the
houseNumberOrName
,street
,postalCode
, orstateOrProvince
are provided.countrystringThe two-character country code of the address in ISO-3166-1 alpha-2 format. For example, NL.
houseNumberOrNamestringThe number or name of the house.
postalCodestringThe postal code. Required if the
houseNumberOrName
,street
,city
, orstateOrProvince
are provided.Maximum length:
-
5 digits for addresses in the US.
-
10 characters for all other countries.
stateOrProvincestringThe abbreviation of the state or province. Required if the
houseNumberOrName
,street
,city
, orpostalCode
are provided.Maximum length:
-
2 characters for addresses in the US or Canada.
-
3 characters for all other countries.
streetstringThe name of the street. Required if the
houseNumberOrName
,city
,postalCode
, orstateOrProvince
are provided.bankAccountDetailsarray[object]Array of bank accounts associated with the account holder. For details about the required
bankAccountDetail
fields, see Required information.accountNumberstringThe bank account number (without separators).
Refer to Required information for details on field requirements.
accountTypestringThe type of bank account. Only applicable to bank accounts held in the USA. The permitted values are:
checking
,savings
.Refer to Required information for details on field requirements.
bankAccountNamestringThe name of the bank account.
bankAccountReferencestringMerchant reference to the bank account.
bankAccountUUIDstringThe unique identifier (UUID) of the Bank Account.
If, during an account holder create or update request, this field is left blank (but other fields provided), a new Bank Account will be created with a procedurally-generated UUID.
If, during an account holder create request, a UUID is provided, the creation of the Bank Account will fail while the creation of the account holder will continue.
If, during an account holder update request, a UUID that is not correlated with an existing Bank Account is provided, the update of the account holder will fail.
If, during an account holder update request, a UUID that is correlated with an existing Bank Account is provided, the existing Bank Account will be updated.
bankBicSwiftstringThe bank identifier code.
Refer to Required information for details on field requirements.
bankCitystringThe city in which the bank branch is located.
Refer to Required information for details on field requirements.
bankCodestringThe bank code of the banking institution with which the bank account is registered.
Refer to Required information for details on field requirements.
bankNamestringThe name of the banking institution with which the bank account is held.
Refer to Required information for details on field requirements.
branchCodestringThe branch code of the branch under which the bank account is registered. The value to be specified in this parameter depends on the country of the bank account:
- United States - Routing number
- United Kingdom - Sort code
- Germany - Bankleitzahl
Refer to Required information for details on field requirements.
checkCodestringThe check code of the bank account.
Refer to Required information for details on field requirements.
countryCodestringThe two-letter country code in which the bank account is registered.
The permitted country codes are defined in ISO-3166-1 alpha-2 (e.g. 'NL').
Refer to Required information for details on field requirements.
currencyCodestringThe currency in which the bank account deals.
The permitted currency codes are defined in ISO-4217 (e.g. 'EUR').
ibanstringThe international bank account number.
The IBAN standard is defined in ISO-13616.
Refer to Required information for details on field requirements.
ownerCitystringThe city of residence of the bank account owner.
Refer to Required information for details on field requirements.
ownerCountryCodestringThe country code of the country of residence of the bank account owner.
The permitted country codes are defined in ISO-3166-1 alpha-2 (e.g. 'NL').
Refer to Required information for details on field requirements.
ownerDateOfBirthstringDeprecatedThe date of birth of the bank account owner. The date should be in ISO-8601 format yyyy-mm-dd (e.g. 2000-01-31).
ownerHouseNumberOrNamestringThe house name or number of the residence of the bank account owner.
Refer to Required information for details on field requirements.
ownerNamestringThe name of the bank account owner.
Refer to Required information for details on field requirements.
ownerNationalitystringThe country code of the country of nationality of the bank account owner.
The permitted country codes are defined in ISO-3166-1 alpha-2 (e.g. 'NL').
Refer to Required information for details on field requirements.
ownerPostalCodestringThe postal code of the residence of the bank account owner.
Refer to Required information for details on field requirements.
ownerStatestringThe state of residence of the bank account owner.
Refer to Required information for details on field requirements.
ownerStreetstringThe street name of the residence of the bank account owner.
Refer to Required information for details on field requirements.
primaryAccountbooleanIf set to true, the bank account is a primary account.
taxIdstringThe tax ID number.
Refer to Required information for details on field requirements.
urlForVerificationstringThe URL to be used for bank account verification. This may be generated on bank account creation.
Refer to Required information for details on field requirements.
bankAggregatorDataReferencestringThe opaque reference value returned by the Adyen API during bank account login.
businessDetailsobjectDetails about the business or nonprofit account holder. Required when creating an account holder with
legalEntity
Business or NonProfit.doingBusinessAsstringThe registered name of the company (if it differs from the legal name of the company).
legalBusinessNamestringThe legal name of the company.
listedUltimateParentCompanyarray[object]Information about the parent public company. Required if the account holder is 100% owned by a publicly listed company.
addressobjectAddress of the ultimate parent company.
citystringThe name of the city. Required if the
houseNumberOrName
,street
,postalCode
, orstateOrProvince
are provided.countrystringThe two-character country code of the address in ISO-3166-1 alpha-2 format. For example, NL.
houseNumberOrNamestringThe number or name of the house.
postalCodestringThe postal code. Required if the
houseNumberOrName
,street
,city
, orstateOrProvince
are provided.Maximum length:
-
5 digits for addresses in the US.
-
10 characters for all other countries.
stateOrProvincestringThe abbreviation of the state or province. Required if the
houseNumberOrName
,street
,city
, orpostalCode
are provided.Maximum length:
-
2 characters for addresses in the US or Canada.
-
3 characters for all other countries.
streetstringThe name of the street. Required if the
houseNumberOrName
,city
,postalCode
, orstateOrProvince
are provided.businessDetailsobjectDetails about the ultimate parent company's business.
legalBusinessNamestringThe legal name of the company.
registrationNumberstringThe registration number of the company.
stockExchangestringMarket Identifier Code (MIC).
stockNumberstringInternational Securities Identification Number (ISIN).
stockTickerstringStock Ticker symbol.
ultimateParentCompanyCodestringAdyen-generated unique alphanumeric identifier (UUID) for the entry, returned in the response when you create an ultimate parent company. Required when updating an existing entry in an
/updateAccountHolder
request.registrationNumberstringThe registration number of the company.
shareholdersarray[object]Array containing information about individuals associated with the account holder either through ownership or control. For details about how you can identify them, refer to our verification guide.
addressobjectThe address of the person.
citystringThe name of the city. Required if the
houseNumberOrName
,street
,postalCode
, orstateOrProvince
are provided.countrystringThe two-character country code of the address in ISO-3166-1 alpha-2 format. For example, NL.
houseNumberOrNamestringThe number or name of the house.
postalCodestringThe postal code. Required if the
houseNumberOrName
,street
,city
, orstateOrProvince
are provided.Maximum length:
-
5 digits for addresses in the US.
-
10 characters for all other countries.
stateOrProvincestringThe abbreviation of the state or province. Required if the
houseNumberOrName
,street
,city
, orpostalCode
are provided.Maximum length:
-
2 characters for addresses in the US or Canada.
-
3 characters for all other countries.
streetstringThe name of the street. Required if the
houseNumberOrName
,city
,postalCode
, orstateOrProvince
are provided.emailstringThe e-mail address of the person.
fullPhoneNumberstringThe phone number of the person provided as a single string. It will be handled as a landline phone. Examples: "0031 6 11 22 33 44", "+316/1122-3344", "(0031) 611223344"
jobTitlestringJob title of the person. Required when the
shareholderType
is Controller.Example values: Chief Executive Officer, Chief Financial Officer, Chief Operating Officer, President, Vice President, Executive President, Managing Member, Partner, Treasurer, Director, or Other.
nameobjectThe name of the person.
firstNamestringMax length: 80The first name.
genderstringMax length: 1The gender.
The following values are permitted:
MALE
,FEMALE
,UNKNOWN
.infixstringMax length: 20The name's infix, if applicable.
A maximum length of twenty (20) characters is imposed.
lastNamestringMax length: 80The last name.
personalDataobjectContains information about the person.
dateOfBirthstringThe person's date of birth, in ISO-8601 YYYY-MM-DD format. For example, 2000-01-31.
documentDataarray[object]Array that contains information about the person's identification document. You can submit only one entry per document type.
expirationDatestringThe expiry date of the document, in ISO-8601 YYYY-MM-DD format. For example, 2000-01-31.
issuerCountrystringMin length: 2Max length: 2The country where the document was issued, in the two-character ISO 3166-1 alpha-2 format. For example, NL.
issuerStatestringThe state where the document was issued (if applicable).
numberstringThe number in the document.
typestringThe type of the document. Possible values: ID, DRIVINGLICENSE, PASSPORT, SOCIALSECURITY, VISA.
To delete an existing entry for a document
type
, send only thetype
field in your request.nationalitystringMin length: 2Max length: 2The nationality of the person represented by a two-character country code, in ISO 3166-1 alpha-2 format. For example, NL.
phoneNumberobjectThe phone number of the person.
phoneCountryCodestringThe two-character country code of the phone number.
The permitted country codes are defined in ISO-3166-1 alpha-2 (e.g. 'NL').
phoneNumberstringThe phone number.
The inclusion of the phone number country code is not necessary.
phoneTypestringThe type of the phone number.
The following values are permitted:
Landline
,Mobile
,SIP
,Fax
.shareholderCodestringThe unique identifier (UUID) of the shareholder entry.
If, during an Account Holder create or update request, this field is left blank (but other fields provided), a new Shareholder will be created with a procedurally-generated UUID.
If, during an Account Holder create request, a UUID is provided, the creation of Account Holder will fail with a validation Error..
If, during an Account Holder update request, a UUID that is not correlated with an existing Shareholder is provided, the update of the Shareholder will fail.
If, during an Account Holder update request, a UUID that is correlated with an existing Shareholder is provided, the existing Shareholder will be updated.
shareholderReferencestringYour reference for the shareholder entry.
shareholderTypestringSpecifies how the person is associated with the account holder.
Possible values:
-
Owner: Individuals who directly or indirectly own 25% or more of a company.
-
Controller: Individuals who are members of senior management staff responsible for managing a company or organization.
webAddressstringThe URL of the person's website.
signatoriesarray[object]Signatories associated with the company. Each array entry should represent one signatory.
addressobjectThe address of the person.
citystringThe name of the city. Required if the
houseNumberOrName
,street
,postalCode
, orstateOrProvince
are provided.countrystringThe two-character country code of the address in ISO-3166-1 alpha-2 format. For example, NL.
houseNumberOrNamestringThe number or name of the house.
postalCodestringThe postal code. Required if the
houseNumberOrName
,street
,city
, orstateOrProvince
are provided.Maximum length:
-
5 digits for addresses in the US.
-
10 characters for all other countries.
stateOrProvincestringThe abbreviation of the state or province. Required if the
houseNumberOrName
,street
,city
, orpostalCode
are provided.Maximum length:
-
2 characters for addresses in the US or Canada.
-
3 characters for all other countries.
streetstringThe name of the street. Required if the
houseNumberOrName
,city
,postalCode
, orstateOrProvince
are provided.emailstringThe e-mail address of the person.
fullPhoneNumberstringThe phone number of the person provided as a single string. It will be handled as a landline phone. Examples: "0031 6 11 22 33 44", "+316/1122-3344", "(0031) 611223344"
jobTitlestringJob title of the signatory.
Example values: Chief Executive Officer, Chief Financial Officer, Chief Operating Officer, President, Vice President, Executive President, Managing Member, Partner, Treasurer, Director, or Other.
nameobjectThe name of the person.
firstNamestringMax length: 80The first name.
genderstringMax length: 1The gender.
The following values are permitted:
MALE
,FEMALE
,UNKNOWN
.infixstringMax length: 20The name's infix, if applicable.
A maximum length of twenty (20) characters is imposed.
lastNamestringMax length: 80The last name.
personalDataobjectContains information about the person.
dateOfBirthstringThe person's date of birth, in ISO-8601 YYYY-MM-DD format. For example, 2000-01-31.
documentDataarray[object]Array that contains information about the person's identification document. You can submit only one entry per document type.
expirationDatestringThe expiry date of the document, in ISO-8601 YYYY-MM-DD format. For example, 2000-01-31.
issuerCountrystringMin length: 2Max length: 2The country where the document was issued, in the two-character ISO 3166-1 alpha-2 format. For example, NL.
issuerStatestringThe state where the document was issued (if applicable).
numberstringThe number in the document.
typestringThe type of the document. Possible values: ID, DRIVINGLICENSE, PASSPORT, SOCIALSECURITY, VISA.
To delete an existing entry for a document
type
, send only thetype
field in your request.nationalitystringMin length: 2Max length: 2The nationality of the person represented by a two-character country code, in ISO 3166-1 alpha-2 format. For example, NL.
phoneNumberobjectThe phone number of the person.
phoneCountryCodestringThe two-character country code of the phone number.
The permitted country codes are defined in ISO-3166-1 alpha-2 (e.g. 'NL').
phoneNumberstringThe phone number.
The inclusion of the phone number country code is not necessary.
phoneTypestringThe type of the phone number.
The following values are permitted:
Landline
,Mobile
,SIP
,Fax
.signatoryCodestringThe unique identifier (UUID) of the signatory.
If, during an Account Holder create or update request, this field is left blank (but other fields provided), a new Signatory will be created with a procedurally-generated UUID.
If, during an Account Holder create request, a UUID is provided, the creation of the Signatory will fail while the creation of the Account Holder will continue.
If, during an Account Holder update request, a UUID that is not correlated with an existing Signatory is provided, the update of the Signatory will fail.
If, during an Account Holder update request, a UUID that is correlated with an existing Signatory is provided, the existing Signatory will be updated.
signatoryReferencestringYour reference for the signatory.
webAddressstringThe URL of the person's website.
stockExchangestringMarket Identifier Code (MIC).
stockNumberstringInternational Securities Identification Number (ISIN).
stockTickerstringStock Ticker symbol.
taxIdstringThe tax ID of the company.
emailstringThe email address of the account holder.
fullPhoneNumberstringThe phone number of the account holder provided as a single string. It will be handled as a landline phone. Examples: "0031 6 11 22 33 44", "+316/1122-3344", "(0031) 611223344"
individualDetailsobjectDetails about the individual account holder. Required when creating an account holder with
legalEntity
Individual.nameobjectThe name of the individual.
Make sure your account holder registers using the name shown on their Photo ID. Maximum length: 80 characters Cannot contain numbers. /n Cannot be empty.
firstNamestringMax length: 80The first name.
genderstringMax length: 1The gender.
The following values are permitted:
MALE
,FEMALE
,UNKNOWN
.infixstringMax length: 20The name's infix, if applicable.
A maximum length of twenty (20) characters is imposed.
lastNamestringMax length: 80The last name.
personalDataobjectPersonal information of the individual.
dateOfBirthstringThe person's date of birth, in ISO-8601 YYYY-MM-DD format. For example, 2000-01-31.
documentDataarray[object]Array that contains information about the person's identification document. You can submit only one entry per document type.
expirationDatestringThe expiry date of the document, in ISO-8601 YYYY-MM-DD format. For example, 2000-01-31.
issuerCountrystringMin length: 2Max length: 2The country where the document was issued, in the two-character ISO 3166-1 alpha-2 format. For example, NL.
issuerStatestringThe state where the document was issued (if applicable).
numberstringThe number in the document.
typestringThe type of the document. Possible values: ID, DRIVINGLICENSE, PASSPORT, SOCIALSECURITY, VISA.
To delete an existing entry for a document
type
, send only thetype
field in your request.nationalitystringMin length: 2Max length: 2The nationality of the person represented by a two-character country code, in ISO 3166-1 alpha-2 format. For example, NL.
lastReviewDatestringDate when you last reviewed the account holder's information, in ISO-8601 YYYY-MM-DD format. For example, 2020-01-31.
legalArrangementsarray[object]An array containing information about the account holder's legal arrangements.
addressobjectThe address of the legal arrangement.
citystringThe name of the city. Required if the
houseNumberOrName
,street
,postalCode
, orstateOrProvince
are provided.countrystringThe two-character country code of the address in ISO-3166-1 alpha-2 format. For example, NL.
houseNumberOrNamestringThe number or name of the house.
postalCodestringThe postal code. Required if the
houseNumberOrName
,street
,city
, orstateOrProvince
are provided.Maximum length:
-
5 digits for addresses in the US.
-
10 characters for all other countries.
stateOrProvincestringThe abbreviation of the state or province. Required if the
houseNumberOrName
,street
,city
, orpostalCode
are provided.Maximum length:
-
2 characters for addresses in the US or Canada.
-
3 characters for all other countries.
streetstringThe name of the street. Required if the
houseNumberOrName
,city
,postalCode
, orstateOrProvince
are provided.legalArrangementCodestringAdyen-generated unique alphanumeric identifier (UUID) for the entry, returned in the response when you create a legal arrangement. Use only when updating an account holder. If you include this field when creating an account holder, the request will fail.
legalArrangementEntitiesarray[object]An array containing information about other entities that are part of the legal arrangement.
addressobjectThe address of the entity.
citystringThe name of the city. Required if the
houseNumberOrName
,street
,postalCode
, orstateOrProvince
are provided.countrystringThe two-character country code of the address in ISO-3166-1 alpha-2 format. For example, NL.
houseNumberOrNamestringThe number or name of the house.
postalCodestringThe postal code. Required if the
houseNumberOrName
,street
,city
, orstateOrProvince
are provided.Maximum length:
-
5 digits for addresses in the US.
-
10 characters for all other countries.
stateOrProvincestringThe abbreviation of the state or province. Required if the
houseNumberOrName
,street
,city
, orpostalCode
are provided.Maximum length:
-
2 characters for addresses in the US or Canada.
-
3 characters for all other countries.
streetstringThe name of the street. Required if the
houseNumberOrName
,city
,postalCode
, orstateOrProvince
are provided.businessDetailsobjectRequired when creating an entity with
legalEntityType
Business, NonProfit, PublicCompany, or Partnership.doingBusinessAsstringThe registered name of the company (if it differs from the legal name of the company).
legalBusinessNamestringThe legal name of the company.
listedUltimateParentCompanyarray[object]Information about the parent public company. Required if the account holder is 100% owned by a publicly listed company.
addressobjectAddress of the ultimate parent company.
citystringThe name of the city. Required if the
houseNumberOrName
,street
,postalCode
, orstateOrProvince
are provided.countrystringThe two-character country code of the address in ISO-3166-1 alpha-2 format. For example, NL.
houseNumberOrNamestringThe number or name of the house.
postalCodestringThe postal code. Required if the
houseNumberOrName
,street
,city
, orstateOrProvince
are provided.Maximum length:
-
5 digits for addresses in the US.
-
10 characters for all other countries.
stateOrProvincestringThe abbreviation of the state or province. Required if the
houseNumberOrName
,street
,city
, orpostalCode
are provided.Maximum length:
-
2 characters for addresses in the US or Canada.
-
3 characters for all other countries.
streetstringThe name of the street. Required if the
houseNumberOrName
,city
,postalCode
, orstateOrProvince
are provided.businessDetailsobjectDetails about the ultimate parent company's business.
legalBusinessNamestringThe legal name of the company.
registrationNumberstringThe registration number of the company.
stockExchangestringMarket Identifier Code (MIC).
stockNumberstringInternational Securities Identification Number (ISIN).
stockTickerstringStock Ticker symbol.
ultimateParentCompanyCodestringAdyen-generated unique alphanumeric identifier (UUID) for the entry, returned in the response when you create an ultimate parent company. Required when updating an existing entry in an
/updateAccountHolder
request.registrationNumberstringThe registration number of the company.
shareholdersarray[object]Array containing information about individuals associated with the account holder either through ownership or control. For details about how you can identify them, refer to our verification guide.
addressobjectThe address of the person.
citystringThe name of the city. Required if the
houseNumberOrName
,street
,postalCode
, orstateOrProvince
are provided.countrystringThe two-character country code of the address in ISO-3166-1 alpha-2 format. For example, NL.
houseNumberOrNamestringThe number or name of the house.
postalCodestringThe postal code. Required if the
houseNumberOrName
,street
,city
, orstateOrProvince
are provided.Maximum length:
-
5 digits for addresses in the US.
-
10 characters for all other countries.
stateOrProvincestringThe abbreviation of the state or province. Required if the
houseNumberOrName
,street
,city
, orpostalCode
are provided.Maximum length:
-
2 characters for addresses in the US or Canada.
-
3 characters for all other countries.
streetstringThe name of the street. Required if the
houseNumberOrName
,city
,postalCode
, orstateOrProvince
are provided.emailstringThe e-mail address of the person.
fullPhoneNumberstringThe phone number of the person provided as a single string. It will be handled as a landline phone. Examples: "0031 6 11 22 33 44", "+316/1122-3344", "(0031) 611223344"
jobTitlestringJob title of the person. Required when the
shareholderType
is Controller.Example values: Chief Executive Officer, Chief Financial Officer, Chief Operating Officer, President, Vice President, Executive President, Managing Member, Partner, Treasurer, Director, or Other.
nameobjectThe name of the person.
firstNamestringMax length: 80The first name.
genderstringMax length: 1The gender.
The following values are permitted:
MALE
,FEMALE
,UNKNOWN
.infixstringMax length: 20The name's infix, if applicable.
A maximum length of twenty (20) characters is imposed.
lastNamestringMax length: 80The last name.
personalDataobjectContains information about the person.
dateOfBirthstringThe person's date of birth, in ISO-8601 YYYY-MM-DD format. For example, 2000-01-31.
documentDataarray[object]Array that contains information about the person's identification document. You can submit only one entry per document type.
expirationDatestringThe expiry date of the document, in ISO-8601 YYYY-MM-DD format. For example, 2000-01-31.
issuerCountrystringMin length: 2Max length: 2The country where the document was issued, in the two-character ISO 3166-1 alpha-2 format. For example, NL.
issuerStatestringThe state where the document was issued (if applicable).
numberstringThe number in the document.
typestringThe type of the document. Possible values: ID, DRIVINGLICENSE, PASSPORT, SOCIALSECURITY, VISA.
To delete an existing entry for a document
type
, send only thetype
field in your request.nationalitystringMin length: 2Max length: 2The nationality of the person represented by a two-character country code, in ISO 3166-1 alpha-2 format. For example, NL.
phoneNumberobjectThe phone number of the person.
phoneCountryCodestringThe two-character country code of the phone number.
The permitted country codes are defined in ISO-3166-1 alpha-2 (e.g. 'NL').
phoneNumberstringThe phone number.
The inclusion of the phone number country code is not necessary.
phoneTypestringThe type of the phone number.
The following values are permitted:
Landline
,Mobile
,SIP
,Fax
.shareholderCodestringThe unique identifier (UUID) of the shareholder entry.
If, during an Account Holder create or update request, this field is left blank (but other fields provided), a new Shareholder will be created with a procedurally-generated UUID.
If, during an Account Holder create request, a UUID is provided, the creation of Account Holder will fail with a validation Error..
If, during an Account Holder update request, a UUID that is not correlated with an existing Shareholder is provided, the update of the Shareholder will fail.
If, during an Account Holder update request, a UUID that is correlated with an existing Shareholder is provided, the existing Shareholder will be updated.
shareholderReferencestringYour reference for the shareholder entry.
shareholderTypestringSpecifies how the person is associated with the account holder.
Possible values:
-
Owner: Individuals who directly or indirectly own 25% or more of a company.
-
Controller: Individuals who are members of senior management staff responsible for managing a company or organization.
webAddressstringThe URL of the person's website.
signatoriesarray[object]Signatories associated with the company. Each array entry should represent one signatory.
addressobjectThe address of the person.
citystringThe name of the city. Required if the
houseNumberOrName
,street
,postalCode
, orstateOrProvince
are provided.countrystringThe two-character country code of the address in ISO-3166-1 alpha-2 format. For example, NL.
houseNumberOrNamestringThe number or name of the house.
postalCodestringThe postal code. Required if the
houseNumberOrName
,street
,city
, orstateOrProvince
are provided.Maximum length:
-
5 digits for addresses in the US.
-
10 characters for all other countries.
stateOrProvincestringThe abbreviation of the state or province. Required if the
houseNumberOrName
,street
,city
, orpostalCode
are provided.Maximum length:
-
2 characters for addresses in the US or Canada.
-
3 characters for all other countries.
streetstringThe name of the street. Required if the
houseNumberOrName
,city
,postalCode
, orstateOrProvince
are provided.emailstringThe e-mail address of the person.
fullPhoneNumberstringThe phone number of the person provided as a single string. It will be handled as a landline phone. Examples: "0031 6 11 22 33 44", "+316/1122-3344", "(0031) 611223344"
jobTitlestringJob title of the signatory.
Example values: Chief Executive Officer, Chief Financial Officer, Chief Operating Officer, President, Vice President, Executive President, Managing Member, Partner, Treasurer, Director, or Other.
nameobjectThe name of the person.
firstNamestringMax length: 80The first name.
genderstringMax length: 1The gender.
The following values are permitted:
MALE
,FEMALE
,UNKNOWN
.infixstringMax length: 20The name's infix, if applicable.
A maximum length of twenty (20) characters is imposed.
lastNamestringMax length: 80The last name.
personalDataobjectContains information about the person.
dateOfBirthstringThe person's date of birth, in ISO-8601 YYYY-MM-DD format. For example, 2000-01-31.
documentDataarray[object]Array that contains information about the person's identification document. You can submit only one entry per document type.
expirationDatestringThe expiry date of the document, in ISO-8601 YYYY-MM-DD format. For example, 2000-01-31.
issuerCountrystringMin length: 2Max length: 2The country where the document was issued, in the two-character ISO 3166-1 alpha-2 format. For example, NL.
issuerStatestringThe state where the document was issued (if applicable).
numberstringThe number in the document.
typestringThe type of the document. Possible values: ID, DRIVINGLICENSE, PASSPORT, SOCIALSECURITY, VISA.
To delete an existing entry for a document
type
, send only thetype
field in your request.nationalitystringMin length: 2Max length: 2The nationality of the person represented by a two-character country code, in ISO 3166-1 alpha-2 format. For example, NL.
phoneNumberobjectThe phone number of the person.
phoneCountryCodestringThe two-character country code of the phone number.
The permitted country codes are defined in ISO-3166-1 alpha-2 (e.g. 'NL').
phoneNumberstringThe phone number.
The inclusion of the phone number country code is not necessary.
phoneTypestringThe type of the phone number.
The following values are permitted:
Landline
,Mobile
,SIP
,Fax
.signatoryCodestringThe unique identifier (UUID) of the signatory.
If, during an Account Holder create or update request, this field is left blank (but other fields provided), a new Signatory will be created with a procedurally-generated UUID.
If, during an Account Holder create request, a UUID is provided, the creation of the Signatory will fail while the creation of the Account Holder will continue.
If, during an Account Holder update request, a UUID that is not correlated with an existing Signatory is provided, the update of the Signatory will fail.
If, during an Account Holder update request, a UUID that is correlated with an existing Signatory is provided, the existing Signatory will be updated.
signatoryReferencestringYour reference for the signatory.
webAddressstringThe URL of the person's website.
stockExchangestringMarket Identifier Code (MIC).
stockNumberstringInternational Securities Identification Number (ISIN).
stockTickerstringStock Ticker symbol.
taxIdstringThe tax ID of the company.
emailstringThe e-mail address of the entity.
fullPhoneNumberstringThe phone number of the contact provided as a single string. It will be handled as a landline phone. Examples: "0031 6 11 22 33 44", "+316/1122-3344", "(0031) 611223344"
individualDetailsobjectRequired when creating an entity with
legalEntityType
Individual.nameobjectThe name of the individual.
Make sure your account holder registers using the name shown on their Photo ID. Maximum length: 80 characters Cannot contain numbers. /n Cannot be empty.
firstNamestringMax length: 80The first name.
genderstringMax length: 1The gender.
The following values are permitted:
MALE
,FEMALE
,UNKNOWN
.infixstringMax length: 20The name's infix, if applicable.
A maximum length of twenty (20) characters is imposed.
lastNamestringMax length: 80The last name.
personalDataobjectPersonal information of the individual.
dateOfBirthstringThe person's date of birth, in ISO-8601 YYYY-MM-DD format. For example, 2000-01-31.
documentDataarray[object]Array that contains information about the person's identification document. You can submit only one entry per document type.
expirationDatestringThe expiry date of the document, in ISO-8601 YYYY-MM-DD format. For example, 2000-01-31.
issuerCountrystringMin length: 2Max length: 2The country where the document was issued, in the two-character ISO 3166-1 alpha-2 format. For example, NL.
issuerStatestringThe state where the document was issued (if applicable).
numberstringThe number in the document.
typestringThe type of the document. Possible values: ID, DRIVINGLICENSE, PASSPORT, SOCIALSECURITY, VISA.
To delete an existing entry for a document
type
, send only thetype
field in your request.nationalitystringMin length: 2Max length: 2The nationality of the person represented by a two-character country code, in ISO 3166-1 alpha-2 format. For example, NL.
legalArrangementEntityCodestringAdyen-generated unique alphanumeric identifier (UUID) for the entry, returned in the response when you create a legal arrangement entity. Use only when updating an account holder. If you include this field when creating an account holder, the request will fail.
legalArrangementEntityReferencestringYour reference for the legal arrangement entity.
legalArrangementMembersarray[string]An array containing the roles of the entity in the legal arrangement.
The possible values depend on the legal arrangement
type
.-
For
type
Association: ControllingPerson and Shareholder. -
For
type
Partnership: Partner and Shareholder. -
For
type
Trust: Trustee, Settlor, Protector, Beneficiary, and Shareholder.
legalEntityTypestringThe legal entity type.
Possible values: Business, Individual, NonProfit, PublicCompany, or Partnership.
phoneNumberobjectThe phone number of the entity.
phoneCountryCodestringThe two-character country code of the phone number.
The permitted country codes are defined in ISO-3166-1 alpha-2 (e.g. 'NL').
phoneNumberstringThe phone number.
The inclusion of the phone number country code is not necessary.
phoneTypestringThe type of the phone number.
The following values are permitted:
Landline
,Mobile
,SIP
,Fax
.webAddressstringThe URL of the website of the contact.
legalArrangementReferencestringYour reference for the legal arrangement. Must be between 3 to 128 characters.
legalFormstringThe form of legal arrangement. Required if
type
is Trust or Partnership.The possible values depend on the
type
.-
For
type
Trust: CashManagementTrust, CorporateUnitTrust, DeceasedEstate, DiscretionaryInvestmentTrust, DiscretionaryServicesManagementTrust, DiscretionaryTradingTrust, FirstHomeSaverAccountsTrust, FixedTrust, FixedUnitTrust, HybridTrust, ListedPublicUnitTrust, OtherTrust, PooledSuperannuationTrust, PublicTradingTrust, or UnlistedPublicUnitTrust. -
For
type
Partnership: LimitedPartnership, FamilyPartnership, or OtherPartnership
namestringThe legal name of the legal arrangement. Minimum length: 3 characters.
registrationNumberstringThe registration number of the legal arrangement.
taxNumberstringThe tax identification number of the legal arrangement.
typestringmerchantCategoryCodestringThe Merchant Category Code of the account holder.
If not specified in the request, this will be derived from the platform account (which is configured by Adyen).
metadataobjectA set of key and value pairs for general use by the account holder or merchant. The keys do not have specific names and may be used for storing miscellaneous data as desired.
The values being stored have a maximum length of eighty (80) characters and will be truncated if necessary. Note that during an update of metadata, the omission of existing key-value pairs will result in the deletion of those key-value pairs.
payoutMethodsarray[object]Array of tokenized card details associated with the account holder. For details about how you can use the tokens to pay out, refer to Pay out to cards.
merchantAccountstringThe
merchantAccount
you used in the/payments
request when you saved the account holder's card details.payoutMethodCodestringAdyen-generated unique alphanumeric identifier (UUID) for the payout method, returned in the response when you create a payout method. Required when updating an existing payout method in an
/updateAccountHolder
request.payoutMethodReferencestringYour reference for the payout method.
recurringDetailReferencestringThe
recurringDetailReference
returned in the/payments
response when you saved the account holder's card details.shopperReferencestringThe
shopperReference
you sent in the/payments
request when you saved the account holder's card details.phoneNumberobjectThe phone number of the account holder.
Required if a
fullPhoneNumber
is not provided.phoneCountryCodestringThe two-character country code of the phone number.
The permitted country codes are defined in ISO-3166-1 alpha-2 (e.g. 'NL').
phoneNumberstringThe phone number.
The inclusion of the phone number country code is not necessary.
phoneTypestringThe type of the phone number.
The following values are permitted:
Landline
,Mobile
,SIP
,Fax
.principalBusinessAddressobjectThe principal business address of the account holder.
citystringThe name of the city. Required if the
houseNumberOrName
,street
,postalCode
, orstateOrProvince
are provided.countrystringThe two-character country code of the address in ISO-3166-1 alpha-2 format. For example, NL.
houseNumberOrNamestringThe number or name of the house.
postalCodestringThe postal code. Required if the
houseNumberOrName
,street
,city
, orstateOrProvince
are provided.Maximum length:
-
5 digits for addresses in the US.
-
10 characters for all other countries.
stateOrProvincestringThe abbreviation of the state or province. Required if the
houseNumberOrName
,street
,city
, orpostalCode
are provided.Maximum length:
-
2 characters for addresses in the US or Canada.
-
3 characters for all other countries.
streetstringThe name of the street. Required if the
houseNumberOrName
,city
,postalCode
, orstateOrProvince
are provided.storeDetailsarray[object]Array of stores associated with the account holder. Required when onboarding account holders that have an Adyen point of sale.
addressobjectThe address of the physical store where the account holder will process payments from.
citystringThe name of the city. Required if the
houseNumberOrName
,street
,postalCode
, orstateOrProvince
are provided.countrystringThe two-character country code of the address in ISO-3166-1 alpha-2 format. For example, NL.
houseNumberOrNamestringThe number or name of the house.
postalCodestringThe postal code. Required if the
houseNumberOrName
,street
,city
, orstateOrProvince
are provided.Maximum length:
-
5 digits for addresses in the US.
-
10 characters for all other countries.
stateOrProvincestringThe abbreviation of the state or province. Required if the
houseNumberOrName
,street
,city
, orpostalCode
are provided.Maximum length:
-
2 characters for addresses in the US or Canada.
-
3 characters for all other countries.
streetstringThe name of the street. Required if the
houseNumberOrName
,city
,postalCode
, orstateOrProvince
are provided.fullPhoneNumberstringThe phone number of the store provided as a single string. It will be handled as a landline phone.
Examples: "0031 6 11 22 33 44", "+316/1122-3344", "(0031) 611223344"
logostringStore logo for payment method setup.
merchantAccountstringThe merchant account to which the store belongs.
merchantCategoryCodestringThe merchant category code (MCC) that classifies the business of the account holder.
merchantHouseNumberstringMerchant house number for payment method setup.
phoneNumberobjectThe phone number of the store.
phoneCountryCodestringThe two-character country code of the phone number.
The permitted country codes are defined in ISO-3166-1 alpha-2 (e.g. 'NL').
phoneNumberstringThe phone number.
The inclusion of the phone number country code is not necessary.
phoneTypestringThe type of the phone number.
The following values are permitted:
Landline
,Mobile
,SIP
,Fax
.shopperInteractionstringThe sales channel. Possible values: Ecommerce, POS.
splitConfigurationUUIDstringThe unique reference for the split configuration, returned when you configure splits in your Customer Area. When this is provided, the
virtualAccount
is also required. Adyen uses the configuration and thevirtualAccount
to split funds between accounts in your platform.statusstringThe status of the store. Possible values: Pending, Active, Inactive, InactiveWithModifications, Closed.
storestringAdyen-generated unique alphanumeric identifier (UUID) for the store, returned in the response when you create a store. Required when updating an existing store in an
/updateAccountHolder
request.storeNamestringThe name of the account holder's store. This value is shown in shopper statements.
-
Length: Between 3 to 22 characters
-
The following characters are not supported: :;}{$#@!|<>%^*+=\
Note: storeName does not appear in American Express shopper statements by default. Contact Adyen Support to enable this for American Express.
storeReferencestringYour unique identifier for the store. The Customer Area also uses this value for the store description.
-
Length: Between 3 to 128 characters
-
The following characters are not supported: :;}{$#@!|<>%^*+=\
virtualAccountstringThe account holder's
accountCode
where the split amount will be sent. Required when you provide thesplitConfigurationUUID
.webAddressstringURL of the ecommerce store.
webAddressstringThe URL of the website of the account holder.
accountHolderStatusobjectThe status of the account holder.
eventsarray[object]A list of events scheduled for the account holder.
eventstringThe event.
Permitted values:
InactivateAccount
,RefundNotPaidOutTransfers
. For more information, refer to Verification checks.executionDatestringThe date on which the event will take place.
reasonstringThe reason why this event has been created.
payoutStateobjectThe payout state of the account holder.
allowPayoutbooleanIndicates whether payouts are allowed. This field is the overarching payout status, and is the aggregate of multiple conditions (e.g., KYC status, disabled flag, etc). If this field is false, no payouts will be permitted for any of the account holder's accounts. If this field is true, payouts will be permitted for any of the account holder's accounts.
disableReasonstringThe reason why payouts (to all of the account holder's accounts) have been disabled (by the platform). If the
disabled
field is true, this field can be used to explain why.disabledbooleanIndicates whether payouts have been disabled (by the platform) for all of the account holder's accounts. A platform may enable and disable this field at their discretion. If this field is true,
allowPayout
will be false and no payouts will be permitted for any of the account holder's accounts. If this field is false,allowPayout
may or may not be enabled, depending on other factors.notAllowedReasonstringThe reason why payouts (to all of the account holder's accounts) have been disabled (by Adyen). If payouts have been disabled by Adyen, this field will explain why. If this field is blank, payouts have not been disabled by Adyen.
payoutLimitobjectThe maximum amount that payouts are limited to. Only applies if payouts are allowed but limited.
valueintegerThe amount of the transaction, in minor units.
tierNumberintegerThe payout tier that the account holder occupies.
processingStateobjectThe processing state of the account holder.
disableReasonstringThe reason why processing has been disabled.
disabledbooleanIndicates whether the processing of payments is allowed.
processedFromobjectThe lower bound of the processing tier (i.e., an account holder must have processed at least this amount of money in order to be placed into this tier).
valueintegerThe amount of the transaction, in minor units.
processedToobjectThe upper bound of the processing tier (i.e., an account holder must have processed less than this amount of money in order to be placed into this tier).
valueintegerThe amount of the transaction, in minor units.
tierNumberintegerThe processing tier that the account holder occupies.
statusstringThe status of the account holder.
Permitted values:
Active
,Inactive
,Suspended
,Closed
.statusReasonstringThe reason why the status was assigned to the account holder.
accountsarray[object]A list of the accounts under the account holder.
accountCodestringThe code of the account.
bankAccountUUIDstringThe bankAccountUUID of the bank account held by the account holder to couple the account with. Scheduled payouts in currencies matching the currency of this bank account will be sent to this bank account. Payouts in different currencies will be sent to a matching bank account of the account holder.
beneficiaryAccountstringThe beneficiary of the account.
beneficiaryMerchantReferencestringThe reason that a beneficiary has been set up for this account. This may have been supplied during the setup of a beneficiary at the discretion of the executing user.
descriptionstringA description of the account.
metadataobjectA set of key and value pairs for general use by the merchant. The keys do not have specific names and may be used for storing miscellaneous data as desired.
Note that during an update of metadata, the omission of existing key-value pairs will result in the deletion of those key-value pairs.
payoutMethodCodestringThe payout method code held by the account holder to couple the account with. Scheduled card payouts will be sent using this payout method code.
payoutScheduleobjectThe account's payout schedule.
nextScheduledPayoutstringThe date of the next scheduled payout.
schedulestringThe payout schedule for the account.
Possible values:
DEFAULT
,DAILY
,DAILY_US
,DAILY_EU
,DAILY_AU
,DAILY_SG
,WEEKLY
,WEEKLY_ON_TUE_FRI_MIDNIGHT
,BIWEEKLY_ON_1ST_AND_15TH_AT_MIDNIGHT
,MONTHLY
,HOLD
.HOLD
prevents scheduled payouts, but you can still initiate payouts manually.payoutSpeedstringSpeed with which payouts for this account are processed. Permitted values:
STANDARD
,SAME_DAY
.statusstringThe status of the account. Possible values:
Active
,Inactive
,Suspended
,Closed
.descriptionstringThe description of the account holder.
invalidFieldsarray[object]Contains field validation errors that would prevent requests from being processed.
errorCodeintegerThe validation error code.
errorDescriptionstringA description of the validation error.
fieldTypeobjectThe type of error field.
fieldstringThe full name of the property.
fieldNamestringThe type of the field.
shareholderCodestringThe code of the shareholder that the field belongs to. If empty, the field belongs to an account holder.
legalEntitystringThe legal entity of the account holder.
migrationDataobjectDetails of the account holder migrated to the balance platform.
accountHolderIdstringThe unique identifier of the account holder in the balance platform.
balancePlatformstringThe unique identifier of the balance platfrom to which the account holder was migrated.
migratedbooleanSet to true if the account holder has been migrated.
migratedAccountsarray[object]Contains the mapping of virtual account codes (classic integration) to the balance account codes (balance platform) associated with the migrated account holder.
accountCodestringThe unique identifier of the account of the migrated account holder in the classic integration.
balanceAccountIdstringThe unique identifier of the account of the migrated account holder in the balance platform.
migratedShareholdersarray[object]Contains the mapping of shareholders associated with the migrated legal entities.
legalEntityCodestringThe unique identifier of the legal entity of that shareholder in the balance platform.
shareholderCodestringThe unique identifier of the account of the migrated shareholder in the classic integration.
migratedStoresarray[object]Contains the mapping of business lines and stores associated with the migrated account holder.
businessLineIdstringThe unique identifier of the business line associated with the migrated account holder in the balance platform.
storeCodestringThe unique identifier of the store associated with the migrated account holder in the classic integration.
storeIdstringThe unique identifier of the store associated with the migrated account holder in the balance platform.
storeReferencestringYour reference for the store in the classic integration. The Customer Area uses this value for the store description.
migrationDatestringThe date when account holder was migrated.
primaryCurrencystringThe three-character ISO currency code, with which the prospective account holder primarily deals.
pspReferencestringThe reference of a request. Can be used to uniquely identify the request.
resultCodestringThe result code.
systemUpToDateTimestringThe time that shows how up to date is the information in the response.
verificationobjectThe details of KYC Verification of the account holder.
accountHolderobjectThe results of the checks on the account holder.
checksarray[object]A list of the checks and their statuses.
requiredFieldsarray[string]A list of the fields required for execution of the check.
statusstringThe status of the check.
Possible values: AWAITING_DATA , DATA_PROVIDED, FAILED, INVALID_DATA, PASSED, PENDING, RETRY_LIMIT_REACHED.
summaryobjectA summary of the execution of the check.
kycCheckCodeintegerThe code of the check. For possible values, refer to Verification codes.
kycCheckDescriptionstringA description of the check.
typestringThe type of check.
Possible values:
-
BANK_ACCOUNT_VERIFICATION: Used in v5 and earlier. Replaced by PAYOUT_METHOD_VERIFICATION in v6 and later.
-
COMPANY_VERIFICATION
-
CARD_VERIFICATION
-
IDENTITY_VERIFICATION
-
LEGAL_ARRANGEMENT_VERIFICATION
-
NONPROFIT_VERIFICATION
-
PASSPORT_VERIFICATION
-
PAYOUT_METHOD_VERIFICATION: Used in v6 and later.
-
PCI_VERIFICATION
legalArrangementsarray[object]The results of the checks on the legal arrangements.
checksarray[object]A list of the checks and their statuses.
requiredFieldsarray[string]A list of the fields required for execution of the check.
statusstringThe status of the check.
Possible values: AWAITING_DATA , DATA_PROVIDED, FAILED, INVALID_DATA, PASSED, PENDING, RETRY_LIMIT_REACHED.
summaryobjectA summary of the execution of the check.
kycCheckCodeintegerThe code of the check. For possible values, refer to Verification codes.
kycCheckDescriptionstringA description of the check.
typestringThe type of check.
Possible values:
-
BANK_ACCOUNT_VERIFICATION: Used in v5 and earlier. Replaced by PAYOUT_METHOD_VERIFICATION in v6 and later.
-
COMPANY_VERIFICATION
-
CARD_VERIFICATION
-
IDENTITY_VERIFICATION
-
LEGAL_ARRANGEMENT_VERIFICATION
-
NONPROFIT_VERIFICATION
-
PASSPORT_VERIFICATION
-
PAYOUT_METHOD_VERIFICATION: Used in v6 and later.
-
PCI_VERIFICATION
legalArrangementCodestringThe unique ID of the legal arrangement to which the check applies.
legalArrangementsEntitiesarray[object]The results of the checks on the legal arrangement entities.
checksarray[object]A list of the checks and their statuses.
requiredFieldsarray[string]A list of the fields required for execution of the check.
statusstringThe status of the check.
Possible values: AWAITING_DATA , DATA_PROVIDED, FAILED, INVALID_DATA, PASSED, PENDING, RETRY_LIMIT_REACHED.
summaryobjectA summary of the execution of the check.
kycCheckCodeintegerThe code of the check. For possible values, refer to Verification codes.
kycCheckDescriptionstringA description of the check.
typestringThe type of check.
Possible values:
-
BANK_ACCOUNT_VERIFICATION: Used in v5 and earlier. Replaced by PAYOUT_METHOD_VERIFICATION in v6 and later.
-
COMPANY_VERIFICATION
-
CARD_VERIFICATION
-
IDENTITY_VERIFICATION
-
LEGAL_ARRANGEMENT_VERIFICATION
-
NONPROFIT_VERIFICATION
-
PASSPORT_VERIFICATION
-
PAYOUT_METHOD_VERIFICATION: Used in v6 and later.
-
PCI_VERIFICATION
legalArrangementCodestringThe unique ID of the legal arrangement to which the entity belongs.
legalArrangementEntityCodestringThe unique ID of the legal arrangement entity to which the check applies.
payoutMethodsarray[object]The results of the checks on the payout methods.
checksarray[object]A list of the checks and their statuses.
requiredFieldsarray[string]A list of the fields required for execution of the check.
statusstringThe status of the check.
Possible values: AWAITING_DATA , DATA_PROVIDED, FAILED, INVALID_DATA, PASSED, PENDING, RETRY_LIMIT_REACHED.
summaryobjectA summary of the execution of the check.
kycCheckCodeintegerThe code of the check. For possible values, refer to Verification codes.
kycCheckDescriptionstringA description of the check.
typestringThe type of check.
Possible values:
-
BANK_ACCOUNT_VERIFICATION: Used in v5 and earlier. Replaced by PAYOUT_METHOD_VERIFICATION in v6 and later.
-
COMPANY_VERIFICATION
-
CARD_VERIFICATION
-
IDENTITY_VERIFICATION
-
LEGAL_ARRANGEMENT_VERIFICATION
-
NONPROFIT_VERIFICATION
-
PASSPORT_VERIFICATION
-
PAYOUT_METHOD_VERIFICATION: Used in v6 and later.
-
PCI_VERIFICATION
payoutMethodCodestringThe unique ID of the payoput method to which the check applies.
shareholdersarray[object]The results of the checks on the shareholders.
checksarray[object]A list of the checks and their statuses.
requiredFieldsarray[string]A list of the fields required for execution of the check.
statusstringThe status of the check.
Possible values: AWAITING_DATA , DATA_PROVIDED, FAILED, INVALID_DATA, PASSED, PENDING, RETRY_LIMIT_REACHED.
summaryobjectA summary of the execution of the check.
kycCheckCodeintegerThe code of the check. For possible values, refer to Verification codes.
kycCheckDescriptionstringA description of the check.
typestringThe type of check.
Possible values:
-
BANK_ACCOUNT_VERIFICATION: Used in v5 and earlier. Replaced by PAYOUT_METHOD_VERIFICATION in v6 and later.
-
COMPANY_VERIFICATION
-
CARD_VERIFICATION
-
IDENTITY_VERIFICATION
-
LEGAL_ARRANGEMENT_VERIFICATION
-
NONPROFIT_VERIFICATION
-
PASSPORT_VERIFICATION
-
PAYOUT_METHOD_VERIFICATION: Used in v6 and later.
-
PCI_VERIFICATION
legalArrangementCodestringThe unique ID of the legal arrangement to which the shareholder belongs, if applicable.
legalArrangementEntityCodestringThe unique ID of the legal arrangement entity to which the shareholder belongs, if applicable.
shareholderCodestringThe code of the shareholder to which the check applies.
signatoriesarray[object]The results of the checks on the signatories.
checksarray[object]A list of the checks and their statuses.
requiredFieldsarray[string]A list of the fields required for execution of the check.
statusstringThe status of the check.
Possible values: AWAITING_DATA , DATA_PROVIDED, FAILED, INVALID_DATA, PASSED, PENDING, RETRY_LIMIT_REACHED.
summaryobjectA summary of the execution of the check.
kycCheckCodeintegerThe code of the check. For possible values, refer to Verification codes.
kycCheckDescriptionstringA description of the check.
typestringThe type of check.
Possible values:
-
BANK_ACCOUNT_VERIFICATION: Used in v5 and earlier. Replaced by PAYOUT_METHOD_VERIFICATION in v6 and later.
-
COMPANY_VERIFICATION
-
CARD_VERIFICATION
-
IDENTITY_VERIFICATION
-
LEGAL_ARRANGEMENT_VERIFICATION
-
NONPROFIT_VERIFICATION
-
PASSPORT_VERIFICATION
-
PAYOUT_METHOD_VERIFICATION: Used in v6 and later.
-
PCI_VERIFICATION
signatoryCodestringThe code of the signatory to which the check applies.
ultimateParentCompanyarray[object]The result of the check on the Ultimate Parent Company.
checksarray[object]A list of the checks and their statuses.
requiredFieldsarray[string]A list of the fields required for execution of the check.
statusstringThe status of the check.
Possible values: AWAITING_DATA , DATA_PROVIDED, FAILED, INVALID_DATA, PASSED, PENDING, RETRY_LIMIT_REACHED.
summaryobjectA summary of the execution of the check.
kycCheckCodeintegerThe code of the check. For possible values, refer to Verification codes.
kycCheckDescriptionstringA description of the check.
typestringThe type of check.
Possible values:
-
BANK_ACCOUNT_VERIFICATION: Used in v5 and earlier. Replaced by PAYOUT_METHOD_VERIFICATION in v6 and later.
-
COMPANY_VERIFICATION
-
CARD_VERIFICATION
-
IDENTITY_VERIFICATION
-
LEGAL_ARRANGEMENT_VERIFICATION
-
NONPROFIT_VERIFICATION
-
PASSPORT_VERIFICATION
-
PAYOUT_METHOD_VERIFICATION: Used in v6 and later.
-
PCI_VERIFICATION
ultimateParentCompanyCodestringThe code of the Ultimate Parent Company to which the check applies.
verificationProfilestringThe identifier of the profile that applies to this entity.
-
202 - Accepted
The request has been accepted for processing, but the processing has not been completed.
Show moreShow lessaccountHolderCodestringThe code of the account holder.
accountHolderDetailsobjectDetails of the account holder.
addressobjectThe address of the account holder.
citystringThe name of the city. Required if the
houseNumberOrName
,street
,postalCode
, orstateOrProvince
are provided.countrystringThe two-character country code of the address in ISO-3166-1 alpha-2 format. For example, NL.
houseNumberOrNamestringThe number or name of the house.
postalCodestringThe postal code. Required if the
houseNumberOrName
,street
,city
, orstateOrProvince
are provided.Maximum length:
-
5 digits for addresses in the US.
-
10 characters for all other countries.
stateOrProvincestringThe abbreviation of the state or province. Required if the
houseNumberOrName
,street
,city
, orpostalCode
are provided.Maximum length:
-
2 characters for addresses in the US or Canada.
-
3 characters for all other countries.
streetstringThe name of the street. Required if the
houseNumberOrName
,city
,postalCode
, orstateOrProvince
are provided.bankAccountDetailsarray[object]Array of bank accounts associated with the account holder. For details about the required
bankAccountDetail
fields, see Required information.accountNumberstringThe bank account number (without separators).
Refer to Required information for details on field requirements.
accountTypestringThe type of bank account. Only applicable to bank accounts held in the USA. The permitted values are:
checking
,savings
.Refer to Required information for details on field requirements.
bankAccountNamestringThe name of the bank account.
bankAccountReferencestringMerchant reference to the bank account.
bankAccountUUIDstringThe unique identifier (UUID) of the Bank Account.
If, during an account holder create or update request, this field is left blank (but other fields provided), a new Bank Account will be created with a procedurally-generated UUID.
If, during an account holder create request, a UUID is provided, the creation of the Bank Account will fail while the creation of the account holder will continue.
If, during an account holder update request, a UUID that is not correlated with an existing Bank Account is provided, the update of the account holder will fail.
If, during an account holder update request, a UUID that is correlated with an existing Bank Account is provided, the existing Bank Account will be updated.
bankBicSwiftstringThe bank identifier code.
Refer to Required information for details on field requirements.
bankCitystringThe city in which the bank branch is located.
Refer to Required information for details on field requirements.
bankCodestringThe bank code of the banking institution with which the bank account is registered.
Refer to Required information for details on field requirements.
bankNamestringThe name of the banking institution with which the bank account is held.
Refer to Required information for details on field requirements.
branchCodestringThe branch code of the branch under which the bank account is registered. The value to be specified in this parameter depends on the country of the bank account:
- United States - Routing number
- United Kingdom - Sort code
- Germany - Bankleitzahl
Refer to Required information for details on field requirements.
checkCodestringThe check code of the bank account.
Refer to Required information for details on field requirements.
countryCodestringThe two-letter country code in which the bank account is registered.
The permitted country codes are defined in ISO-3166-1 alpha-2 (e.g. 'NL').
Refer to Required information for details on field requirements.
currencyCodestringThe currency in which the bank account deals.
The permitted currency codes are defined in ISO-4217 (e.g. 'EUR').
ibanstringThe international bank account number.
The IBAN standard is defined in ISO-13616.
Refer to Required information for details on field requirements.
ownerCitystringThe city of residence of the bank account owner.
Refer to Required information for details on field requirements.
ownerCountryCodestringThe country code of the country of residence of the bank account owner.
The permitted country codes are defined in ISO-3166-1 alpha-2 (e.g. 'NL').
Refer to Required information for details on field requirements.
ownerDateOfBirthstringDeprecatedThe date of birth of the bank account owner. The date should be in ISO-8601 format yyyy-mm-dd (e.g. 2000-01-31).
ownerHouseNumberOrNamestringThe house name or number of the residence of the bank account owner.
Refer to Required information for details on field requirements.
ownerNamestringThe name of the bank account owner.
Refer to Required information for details on field requirements.
ownerNationalitystringThe country code of the country of nationality of the bank account owner.
The permitted country codes are defined in ISO-3166-1 alpha-2 (e.g. 'NL').
Refer to Required information for details on field requirements.
ownerPostalCodestringThe postal code of the residence of the bank account owner.
Refer to Required information for details on field requirements.
ownerStatestringThe state of residence of the bank account owner.
Refer to Required information for details on field requirements.
ownerStreetstringThe street name of the residence of the bank account owner.
Refer to Required information for details on field requirements.
primaryAccountbooleanIf set to true, the bank account is a primary account.
taxIdstringThe tax ID number.
Refer to Required information for details on field requirements.
urlForVerificationstringThe URL to be used for bank account verification. This may be generated on bank account creation.
Refer to Required information for details on field requirements.
bankAggregatorDataReferencestringThe opaque reference value returned by the Adyen API during bank account login.
businessDetailsobjectDetails about the business or nonprofit account holder. Required when creating an account holder with
legalEntity
Business or NonProfit.doingBusinessAsstringThe registered name of the company (if it differs from the legal name of the company).
legalBusinessNamestringThe legal name of the company.
listedUltimateParentCompanyarray[object]Information about the parent public company. Required if the account holder is 100% owned by a publicly listed company.
addressobjectAddress of the ultimate parent company.
citystringThe name of the city. Required if the
houseNumberOrName
,street
,postalCode
, orstateOrProvince
are provided.countrystringThe two-character country code of the address in ISO-3166-1 alpha-2 format. For example, NL.
houseNumberOrNamestringThe number or name of the house.
postalCodestringThe postal code. Required if the
houseNumberOrName
,street
,city
, orstateOrProvince
are provided.Maximum length:
-
5 digits for addresses in the US.
-
10 characters for all other countries.
stateOrProvincestringThe abbreviation of the state or province. Required if the
houseNumberOrName
,street
,city
, orpostalCode
are provided.Maximum length:
-
2 characters for addresses in the US or Canada.
-
3 characters for all other countries.
streetstringThe name of the street. Required if the
houseNumberOrName
,city
,postalCode
, orstateOrProvince
are provided.businessDetailsobjectDetails about the ultimate parent company's business.
legalBusinessNamestringThe legal name of the company.
registrationNumberstringThe registration number of the company.
stockExchangestringMarket Identifier Code (MIC).
stockNumberstringInternational Securities Identification Number (ISIN).
stockTickerstringStock Ticker symbol.
ultimateParentCompanyCodestringAdyen-generated unique alphanumeric identifier (UUID) for the entry, returned in the response when you create an ultimate parent company. Required when updating an existing entry in an
/updateAccountHolder
request.registrationNumberstringThe registration number of the company.
shareholdersarray[object]Array containing information about individuals associated with the account holder either through ownership or control. For details about how you can identify them, refer to our verification guide.
addressobjectThe address of the person.
citystringThe name of the city. Required if the
houseNumberOrName
,street
,postalCode
, orstateOrProvince
are provided.countrystringThe two-character country code of the address in ISO-3166-1 alpha-2 format. For example, NL.
houseNumberOrNamestringThe number or name of the house.
postalCodestringThe postal code. Required if the
houseNumberOrName
,street
,city
, orstateOrProvince
are provided.Maximum length:
-
5 digits for addresses in the US.
-
10 characters for all other countries.
stateOrProvincestringThe abbreviation of the state or province. Required if the
houseNumberOrName
,street
,city
, orpostalCode
are provided.Maximum length:
-
2 characters for addresses in the US or Canada.
-
3 characters for all other countries.
streetstringThe name of the street. Required if the
houseNumberOrName
,city
,postalCode
, orstateOrProvince
are provided.emailstringThe e-mail address of the person.
fullPhoneNumberstringThe phone number of the person provided as a single string. It will be handled as a landline phone. Examples: "0031 6 11 22 33 44", "+316/1122-3344", "(0031) 611223344"
jobTitlestringJob title of the person. Required when the
shareholderType
is Controller.Example values: Chief Executive Officer, Chief Financial Officer, Chief Operating Officer, President, Vice President, Executive President, Managing Member, Partner, Treasurer, Director, or Other.
nameobjectThe name of the person.
firstNamestringMax length: 80The first name.
genderstringMax length: 1The gender.
The following values are permitted:
MALE
,FEMALE
,UNKNOWN
.infixstringMax length: 20The name's infix, if applicable.
A maximum length of twenty (20) characters is imposed.
lastNamestringMax length: 80The last name.
personalDataobjectContains information about the person.
dateOfBirthstringThe person's date of birth, in ISO-8601 YYYY-MM-DD format. For example, 2000-01-31.
documentDataarray[object]Array that contains information about the person's identification document. You can submit only one entry per document type.
expirationDatestringThe expiry date of the document, in ISO-8601 YYYY-MM-DD format. For example, 2000-01-31.
issuerCountrystringMin length: 2Max length: 2The country where the document was issued, in the two-character ISO 3166-1 alpha-2 format. For example, NL.
issuerStatestringThe state where the document was issued (if applicable).
numberstringThe number in the document.
typestringThe type of the document. Possible values: ID, DRIVINGLICENSE, PASSPORT, SOCIALSECURITY, VISA.
To delete an existing entry for a document
type
, send only thetype
field in your request.nationalitystringMin length: 2Max length: 2The nationality of the person represented by a two-character country code, in ISO 3166-1 alpha-2 format. For example, NL.
phoneNumberobjectThe phone number of the person.
phoneCountryCodestringThe two-character country code of the phone number.
The permitted country codes are defined in ISO-3166-1 alpha-2 (e.g. 'NL').
phoneNumberstringThe phone number.
The inclusion of the phone number country code is not necessary.
phoneTypestringThe type of the phone number.
The following values are permitted:
Landline
,Mobile
,SIP
,Fax
.shareholderCodestringThe unique identifier (UUID) of the shareholder entry.
If, during an Account Holder create or update request, this field is left blank (but other fields provided), a new Shareholder will be created with a procedurally-generated UUID.
If, during an Account Holder create request, a UUID is provided, the creation of Account Holder will fail with a validation Error..
If, during an Account Holder update request, a UUID that is not correlated with an existing Shareholder is provided, the update of the Shareholder will fail.
If, during an Account Holder update request, a UUID that is correlated with an existing Shareholder is provided, the existing Shareholder will be updated.
shareholderReferencestringYour reference for the shareholder entry.
shareholderTypestringSpecifies how the person is associated with the account holder.
Possible values:
-
Owner: Individuals who directly or indirectly own 25% or more of a company.
-
Controller: Individuals who are members of senior management staff responsible for managing a company or organization.
webAddressstringThe URL of the person's website.
signatoriesarray[object]Signatories associated with the company. Each array entry should represent one signatory.
addressobjectThe address of the person.
citystringThe name of the city. Required if the
houseNumberOrName
,street
,postalCode
, orstateOrProvince
are provided.countrystringThe two-character country code of the address in ISO-3166-1 alpha-2 format. For example, NL.
houseNumberOrNamestringThe number or name of the house.
postalCodestringThe postal code. Required if the
houseNumberOrName
,street
,city
, orstateOrProvince
are provided.Maximum length:
-
5 digits for addresses in the US.
-
10 characters for all other countries.
stateOrProvincestringThe abbreviation of the state or province. Required if the
houseNumberOrName
,street
,city
, orpostalCode
are provided.Maximum length:
-
2 characters for addresses in the US or Canada.
-
3 characters for all other countries.
streetstringThe name of the street. Required if the
houseNumberOrName
,city
,postalCode
, orstateOrProvince
are provided.emailstringThe e-mail address of the person.
fullPhoneNumberstringThe phone number of the person provided as a single string. It will be handled as a landline phone. Examples: "0031 6 11 22 33 44", "+316/1122-3344", "(0031) 611223344"
jobTitlestringJob title of the signatory.
Example values: Chief Executive Officer, Chief Financial Officer, Chief Operating Officer, President, Vice President, Executive President, Managing Member, Partner, Treasurer, Director, or Other.
nameobjectThe name of the person.
firstNamestringMax length: 80The first name.
genderstringMax length: 1The gender.
The following values are permitted:
MALE
,FEMALE
,UNKNOWN
.infixstringMax length: 20The name's infix, if applicable.
A maximum length of twenty (20) characters is imposed.
lastNamestringMax length: 80The last name.
personalDataobjectContains information about the person.
dateOfBirthstringThe person's date of birth, in ISO-8601 YYYY-MM-DD format. For example, 2000-01-31.
documentDataarray[object]Array that contains information about the person's identification document. You can submit only one entry per document type.
expirationDatestringThe expiry date of the document, in ISO-8601 YYYY-MM-DD format. For example, 2000-01-31.
issuerCountrystringMin length: 2Max length: 2The country where the document was issued, in the two-character ISO 3166-1 alpha-2 format. For example, NL.
issuerStatestringThe state where the document was issued (if applicable).
numberstringThe number in the document.
typestringThe type of the document. Possible values: ID, DRIVINGLICENSE, PASSPORT, SOCIALSECURITY, VISA.
To delete an existing entry for a document
type
, send only thetype
field in your request.nationalitystringMin length: 2Max length: 2The nationality of the person represented by a two-character country code, in ISO 3166-1 alpha-2 format. For example, NL.
phoneNumberobjectThe phone number of the person.
phoneCountryCodestringThe two-character country code of the phone number.
The permitted country codes are defined in ISO-3166-1 alpha-2 (e.g. 'NL').
phoneNumberstringThe phone number.
The inclusion of the phone number country code is not necessary.
phoneTypestringThe type of the phone number.
The following values are permitted:
Landline
,Mobile
,SIP
,Fax
.signatoryCodestringThe unique identifier (UUID) of the signatory.
If, during an Account Holder create or update request, this field is left blank (but other fields provided), a new Signatory will be created with a procedurally-generated UUID.
If, during an Account Holder create request, a UUID is provided, the creation of the Signatory will fail while the creation of the Account Holder will continue.
If, during an Account Holder update request, a UUID that is not correlated with an existing Signatory is provided, the update of the Signatory will fail.
If, during an Account Holder update request, a UUID that is correlated with an existing Signatory is provided, the existing Signatory will be updated.
signatoryReferencestringYour reference for the signatory.
webAddressstringThe URL of the person's website.
stockExchangestringMarket Identifier Code (MIC).
stockNumberstringInternational Securities Identification Number (ISIN).
stockTickerstringStock Ticker symbol.
taxIdstringThe tax ID of the company.
emailstringThe email address of the account holder.
fullPhoneNumberstringThe phone number of the account holder provided as a single string. It will be handled as a landline phone. Examples: "0031 6 11 22 33 44", "+316/1122-3344", "(0031) 611223344"
individualDetailsobjectDetails about the individual account holder. Required when creating an account holder with
legalEntity
Individual.nameobjectThe name of the individual.
Make sure your account holder registers using the name shown on their Photo ID. Maximum length: 80 characters Cannot contain numbers. /n Cannot be empty.
firstNamestringMax length: 80The first name.
genderstringMax length: 1The gender.
The following values are permitted:
MALE
,FEMALE
,UNKNOWN
.infixstringMax length: 20The name's infix, if applicable.
A maximum length of twenty (20) characters is imposed.
lastNamestringMax length: 80The last name.
personalDataobjectPersonal information of the individual.
dateOfBirthstringThe person's date of birth, in ISO-8601 YYYY-MM-DD format. For example, 2000-01-31.
documentDataarray[object]Array that contains information about the person's identification document. You can submit only one entry per document type.
expirationDatestringThe expiry date of the document, in ISO-8601 YYYY-MM-DD format. For example, 2000-01-31.
issuerCountrystringMin length: 2Max length: 2The country where the document was issued, in the two-character ISO 3166-1 alpha-2 format. For example, NL.
issuerStatestringThe state where the document was issued (if applicable).
numberstringThe number in the document.
typestringThe type of the document. Possible values: ID, DRIVINGLICENSE, PASSPORT, SOCIALSECURITY, VISA.
To delete an existing entry for a document
type
, send only thetype
field in your request.nationalitystringMin length: 2Max length: 2The nationality of the person represented by a two-character country code, in ISO 3166-1 alpha-2 format. For example, NL.
lastReviewDatestringDate when you last reviewed the account holder's information, in ISO-8601 YYYY-MM-DD format. For example, 2020-01-31.
legalArrangementsarray[object]An array containing information about the account holder's legal arrangements.
addressobjectThe address of the legal arrangement.
citystringThe name of the city. Required if the
houseNumberOrName
,street
,postalCode
, orstateOrProvince
are provided.countrystringThe two-character country code of the address in ISO-3166-1 alpha-2 format. For example, NL.
houseNumberOrNamestringThe number or name of the house.
postalCodestringThe postal code. Required if the
houseNumberOrName
,street
,city
, orstateOrProvince
are provided.Maximum length:
-
5 digits for addresses in the US.
-
10 characters for all other countries.
stateOrProvincestringThe abbreviation of the state or province. Required if the
houseNumberOrName
,street
,city
, orpostalCode
are provided.Maximum length:
-
2 characters for addresses in the US or Canada.
-
3 characters for all other countries.
streetstringThe name of the street. Required if the
houseNumberOrName
,city
,postalCode
, orstateOrProvince
are provided.legalArrangementCodestringAdyen-generated unique alphanumeric identifier (UUID) for the entry, returned in the response when you create a legal arrangement. Use only when updating an account holder. If you include this field when creating an account holder, the request will fail.
legalArrangementEntitiesarray[object]An array containing information about other entities that are part of the legal arrangement.
addressobjectThe address of the entity.
citystringThe name of the city. Required if the
houseNumberOrName
,street
,postalCode
, orstateOrProvince
are provided.countrystringThe two-character country code of the address in ISO-3166-1 alpha-2 format. For example, NL.
houseNumberOrNamestringThe number or name of the house.
postalCodestringThe postal code. Required if the
houseNumberOrName
,street
,city
, orstateOrProvince
are provided.Maximum length:
-
5 digits for addresses in the US.
-
10 characters for all other countries.
stateOrProvincestringThe abbreviation of the state or province. Required if the
houseNumberOrName
,street
,city
, orpostalCode
are provided.Maximum length:
-
2 characters for addresses in the US or Canada.
-
3 characters for all other countries.
streetstringThe name of the street. Required if the
houseNumberOrName
,city
,postalCode
, orstateOrProvince
are provided.businessDetailsobjectRequired when creating an entity with
legalEntityType
Business, NonProfit, PublicCompany, or Partnership.doingBusinessAsstringThe registered name of the company (if it differs from the legal name of the company).
legalBusinessNamestringThe legal name of the company.
listedUltimateParentCompanyarray[object]Information about the parent public company. Required if the account holder is 100% owned by a publicly listed company.
addressobjectAddress of the ultimate parent company.
citystringThe name of the city. Required if the
houseNumberOrName
,street
,postalCode
, orstateOrProvince
are provided.countrystringThe two-character country code of the address in ISO-3166-1 alpha-2 format. For example, NL.
houseNumberOrNamestringThe number or name of the house.
postalCodestringThe postal code. Required if the
houseNumberOrName
,street
,city
, orstateOrProvince
are provided.Maximum length:
-
5 digits for addresses in the US.
-
10 characters for all other countries.
stateOrProvincestringThe abbreviation of the state or province. Required if the
houseNumberOrName
,street
,city
, orpostalCode
are provided.Maximum length:
-
2 characters for addresses in the US or Canada.
-
3 characters for all other countries.
streetstringThe name of the street. Required if the
houseNumberOrName
,city
,postalCode
, orstateOrProvince
are provided.businessDetailsobjectDetails about the ultimate parent company's business.
legalBusinessNamestringThe legal name of the company.
registrationNumberstringThe registration number of the company.
stockExchangestringMarket Identifier Code (MIC).
stockNumberstringInternational Securities Identification Number (ISIN).
stockTickerstringStock Ticker symbol.
ultimateParentCompanyCodestringAdyen-generated unique alphanumeric identifier (UUID) for the entry, returned in the response when you create an ultimate parent company. Required when updating an existing entry in an
/updateAccountHolder
request.registrationNumberstringThe registration number of the company.
shareholdersarray[object]Array containing information about individuals associated with the account holder either through ownership or control. For details about how you can identify them, refer to our verification guide.
addressobjectThe address of the person.
citystringThe name of the city. Required if the
houseNumberOrName
,street
,postalCode
, orstateOrProvince
are provided.countrystringThe two-character country code of the address in ISO-3166-1 alpha-2 format. For example, NL.
houseNumberOrNamestringThe number or name of the house.
postalCodestringThe postal code. Required if the
houseNumberOrName
,street
,city
, orstateOrProvince
are provided.Maximum length:
-
5 digits for addresses in the US.
-
10 characters for all other countries.
stateOrProvincestringThe abbreviation of the state or province. Required if the
houseNumberOrName
,street
,city
, orpostalCode
are provided.Maximum length:
-
2 characters for addresses in the US or Canada.
-
3 characters for all other countries.
streetstringThe name of the street. Required if the
houseNumberOrName
,city
,postalCode
, orstateOrProvince
are provided.emailstringThe e-mail address of the person.
fullPhoneNumberstringThe phone number of the person provided as a single string. It will be handled as a landline phone. Examples: "0031 6 11 22 33 44", "+316/1122-3344", "(0031) 611223344"
jobTitlestringJob title of the person. Required when the
shareholderType
is Controller.Example values: Chief Executive Officer, Chief Financial Officer, Chief Operating Officer, President, Vice President, Executive President, Managing Member, Partner, Treasurer, Director, or Other.
nameobjectThe name of the person.
firstNamestringMax length: 80The first name.
genderstringMax length: 1The gender.
The following values are permitted:
MALE
,FEMALE
,UNKNOWN
.infixstringMax length: 20The name's infix, if applicable.
A maximum length of twenty (20) characters is imposed.
lastNamestringMax length: 80The last name.
personalDataobjectContains information about the person.
dateOfBirthstringThe person's date of birth, in ISO-8601 YYYY-MM-DD format. For example, 2000-01-31.
documentDataarray[object]Array that contains information about the person's identification document. You can submit only one entry per document type.
expirationDatestringThe expiry date of the document, in ISO-8601 YYYY-MM-DD format. For example, 2000-01-31.
issuerCountrystringMin length: 2Max length: 2The country where the document was issued, in the two-character ISO 3166-1 alpha-2 format. For example, NL.
issuerStatestringThe state where the document was issued (if applicable).
numberstringThe number in the document.
typestringThe type of the document. Possible values: ID, DRIVINGLICENSE, PASSPORT, SOCIALSECURITY, VISA.
To delete an existing entry for a document
type
, send only thetype
field in your request.nationalitystringMin length: 2Max length: 2The nationality of the person represented by a two-character country code, in ISO 3166-1 alpha-2 format. For example, NL.
phoneNumberobjectThe phone number of the person.
phoneCountryCodestringThe two-character country code of the phone number.
The permitted country codes are defined in ISO-3166-1 alpha-2 (e.g. 'NL').
phoneNumberstringThe phone number.
The inclusion of the phone number country code is not necessary.
phoneTypestringThe type of the phone number.
The following values are permitted:
Landline
,Mobile
,SIP
,Fax
.shareholderCodestringThe unique identifier (UUID) of the shareholder entry.
If, during an Account Holder create or update request, this field is left blank (but other fields provided), a new Shareholder will be created with a procedurally-generated UUID.
If, during an Account Holder create request, a UUID is provided, the creation of Account Holder will fail with a validation Error..
If, during an Account Holder update request, a UUID that is not correlated with an existing Shareholder is provided, the update of the Shareholder will fail.
If, during an Account Holder update request, a UUID that is correlated with an existing Shareholder is provided, the existing Shareholder will be updated.
shareholderReferencestringYour reference for the shareholder entry.
shareholderTypestringSpecifies how the person is associated with the account holder.
Possible values:
-
Owner: Individuals who directly or indirectly own 25% or more of a company.
-
Controller: Individuals who are members of senior management staff responsible for managing a company or organization.
webAddressstringThe URL of the person's website.
signatoriesarray[object]Signatories associated with the company. Each array entry should represent one signatory.
addressobjectThe address of the person.
citystringThe name of the city. Required if the
houseNumberOrName
,street
,postalCode
, orstateOrProvince
are provided.countrystringThe two-character country code of the address in ISO-3166-1 alpha-2 format. For example, NL.
houseNumberOrNamestringThe number or name of the house.
postalCodestringThe postal code. Required if the
houseNumberOrName
,street
,city
, orstateOrProvince
are provided.Maximum length:
-
5 digits for addresses in the US.
-
10 characters for all other countries.
stateOrProvincestringThe abbreviation of the state or province. Required if the
houseNumberOrName
,street
,city
, orpostalCode
are provided.Maximum length:
-
2 characters for addresses in the US or Canada.
-
3 characters for all other countries.
streetstringThe name of the street. Required if the
houseNumberOrName
,city
,postalCode
, orstateOrProvince
are provided.emailstringThe e-mail address of the person.
fullPhoneNumberstringThe phone number of the person provided as a single string. It will be handled as a landline phone. Examples: "0031 6 11 22 33 44", "+316/1122-3344", "(0031) 611223344"
jobTitlestringJob title of the signatory.
Example values: Chief Executive Officer, Chief Financial Officer, Chief Operating Officer, President, Vice President, Executive President, Managing Member, Partner, Treasurer, Director, or Other.
nameobjectThe name of the person.
firstNamestringMax length: 80The first name.
genderstringMax length: 1The gender.
The following values are permitted:
MALE
,FEMALE
,UNKNOWN
.infixstringMax length: 20The name's infix, if applicable.
A maximum length of twenty (20) characters is imposed.
lastNamestringMax length: 80The last name.
personalDataobjectContains information about the person.
dateOfBirthstringThe person's date of birth, in ISO-8601 YYYY-MM-DD format. For example, 2000-01-31.
documentDataarray[object]Array that contains information about the person's identification document. You can submit only one entry per document type.
expirationDatestringThe expiry date of the document, in ISO-8601 YYYY-MM-DD format. For example, 2000-01-31.
issuerCountrystringMin length: 2Max length: 2The country where the document was issued, in the two-character ISO 3166-1 alpha-2 format. For example, NL.
issuerStatestringThe state where the document was issued (if applicable).
numberstringThe number in the document.
typestringThe type of the document. Possible values: ID, DRIVINGLICENSE, PASSPORT, SOCIALSECURITY, VISA.
To delete an existing entry for a document
type
, send only thetype
field in your request.nationalitystringMin length: 2Max length: 2The nationality of the person represented by a two-character country code, in ISO 3166-1 alpha-2 format. For example, NL.
phoneNumberobjectThe phone number of the person.
-