Adyen · Schema
CreateAccountHolderResponse
PaymentsFinancial ServicesFintechAgentic CommercePoint-of-SalePayment Processing
Properties
| Name | Type | Description |
|---|---|---|
| accountCode | string | The code of a new account created for the account holder. |
| accountHolderCode | string | The code of the new account holder. |
| accountHolderDetails | object | Details of the new account holder. |
| accountHolderStatus | object | The status of the new account holder. |
| description | string | The description of the new account holder. |
| invalidFields | array | A list of fields that caused the `/createAccountHolder` request to fail. |
| legalEntity | string | The type of legal entity of the new account holder. |
| primaryCurrency | string | The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes), with which the prospective account holder primarily deals. |
| pspReference | string | The reference of a request. Can be used to uniquely identify the request. |
| resultCode | string | The result code. |
| verification | object | The details of KYC Verification of the account holder. |
| verificationProfile | string | The identifier of the profile that applies to this entity. |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://raw.githubusercontent.com/api-evangelist/adyen/main/json-schema/adyen-create-account-holder-response-schema.json",
"title": "CreateAccountHolderResponse",
"x-generated": "2026-10-12",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/adyen-createaccountholder-api-openapi.yml#/components/schemas/CreateAccountHolderResponse",
"properties": {
"accountCode": {
"description": "The code of a new account created for the account holder.",
"type": "string"
},
"accountHolderCode": {
"description": "The code of the new account holder.",
"type": "string"
},
"accountHolderDetails": {
"description": "Details of the new account holder.",
"$ref": "#/$defs/AccountHolderDetails"
},
"accountHolderStatus": {
"x-addedInVersion": "2",
"description": "The status of the new account holder.",
"$ref": "#/$defs/AccountHolderStatus"
},
"description": {
"x-addedInVersion": "4",
"description": "The description of the new account holder.",
"type": "string"
},
"invalidFields": {
"x-addedInVersion": "5",
"description": "A list of fields that caused the `/createAccountHolder` request to fail.",
"items": {
"$ref": "#/$defs/ErrorFieldType"
},
"type": "array"
},
"legalEntity": {
"x-addedInVersion": "4",
"description": "The type of legal entity of the new account holder.",
"enum": [
"Business",
"Individual",
"NonProfit",
"Partnership",
"PublicCompany"
],
"type": "string"
},
"primaryCurrency": {
"x-addedInVersion": "5",
"deprecated": true,
"description": "The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes), with which the prospective account holder primarily deals.",
"type": "string"
},
"pspReference": {
"description": "The reference of a request. Can be used to uniquely identify the request.",
"type": "string"
},
"resultCode": {
"description": "The result code.",
"type": "string"
},
"verification": {
"x-addedInVersion": "2",
"description": "The details of KYC Verification of the account holder.",
"$ref": "#/$defs/KYCVerificationResult"
},
"verificationProfile": {
"x-addedInVersion": "6",
"description": "The identifier of the profile that applies to this entity.",
"type": "string"
}
},
"type": "object",
"$defs": {
"AccountEvent": {
"properties": {
"event": {
"description": "The event.\n>Permitted values: `InactivateAccount`, `RefundNotPaidOutTransfers`.\nFor more information, refer to [Verification checks](https://docs.adyen.com/marketplaces-and-platforms/classic/verification-process).",
"enum": [
"InactivateAccount",
"RefundNotPaidOutTransfers"
],
"type": "string"
},
"executionDate": {
"description": "The date on which the event will take place.",
"format": "date-time",
"type": "string"
},
"reason": {
"description": "The reason why this event has been created.",
"type": "string"
}
},
"type": "object"
},
"AccountHolderDetails": {
"properties": {
"address": {
"description": "The address of the account holder.",
"$ref": "#/$defs/ViasAddress"
},
"bankAccountDetails": {
"description": "Array of bank accounts associated with the account holder. For details about the required `bankAccountDetail` fields, see [Required information](https://docs.adyen.com/marketplaces-and-platforms/classic/verification-process/required-information).",
"items": {
"$ref": "#/$defs/BankAccountDetail"
},
"type": "array"
},
"bankAggregatorDataReference": {
"x-addedInVersion": "5",
"description": "The opaque reference value returned by the Adyen API during bank account login.",
"type": "string"
},
"businessDetails": {
"description": "Details about the business or nonprofit account holder.\nRequired when creating an account holder with `legalEntity` **Business** or **NonProfit**.",
"$ref": "#/$defs/BusinessDetails"
},
"email": {
"description": "The email address of the account holder.",
"type": "string"
},
"fullPhoneNumber": {
"description": "The phone number of the account holder provided as a single string. It will be handled as a landline phone.\n**Examples:** \"0031 6 11 22 33 44\", \"+316/1122-3344\", \"(0031) 611223344\"",
"type": "string"
},
"individualDetails": {
"description": "Details about the individual account holder.\nRequired when creating an account holder with `legalEntity` **Individual**.\n",
"$ref": "#/$defs/IndividualDetails"
},
"lastReviewDate": {
"description": "Date when you last reviewed the account holder's information, in ISO-8601 YYYY-MM-DD format. For example, **2020-01-31**.",
"type": "string"
},
"legalArrangements": {
"x-addedInVersion": "6",
"description": "An array containing information about the account holder's [legal arrangements](https://docs.adyen.com/marketplaces-and-platforms/classic/verification-process/legal-arrangements).",
"items": {
"$ref": "#/$defs/LegalArrangementDetail"
},
"type": "array"
},
"merchantCategoryCode": {
"description": "The Merchant Category Code of the account holder.\n> If not specified in the request, this will be derived from the platform account (which is configured by Adyen).",
"type": "string"
},
"metadata": {
"additionalProperties": {
"type": "string"
},
"description": "A set of key and value pairs for general use by the account holder or merchant.\nThe keys do not have specific names and may be used for storing miscellaneous data as desired.\n> The values being stored have a maximum length of eighty (80) characters and will be truncated if necessary.\n> Note that during an update of metadata, the omission of existing key-value pairs will result in the deletion of those key-value pairs.",
"type": "object"
},
"payoutMethods": {
"x-addedInVersion": "5",
"description": "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](https://docs.adyen.com/marketplaces-and-platforms/classic/payout-to-cards).",
"items": {
"$ref": "#/$defs/PayoutMethod"
},
"type": "array"
},
"principalBusinessAddress": {
"description": "The principal business address of the account holder.",
"$ref": "#/$defs/ViasAddress"
},
"storeDetails": {
"x-addedInVersion": "5",
"description": "Array of stores associated with the account holder. Required when onboarding account holders that have an Adyen [point of sale](https://docs.adyen.com/marketplaces-and-platforms/classic/platforms-for-pos).",
"items": {
"$ref": "#/$defs/StoreDetail"
},
"type": "array"
},
"webAddress": {
"description": "The URL of the website of the account holder.",
"type": "string"
}
},
"required": [
"address"
],
"type": "object"
},
"AccountHolderStatus": {
"properties": {
"events": {
"description": "A list of events scheduled for the account holder.",
"items": {
"$ref": "#/$defs/AccountEvent"
},
"type": "array"
},
"payoutState": {
"description": "The payout state of the account holder.",
"$ref": "#/$defs/AccountPayoutState"
},
"processingState": {
"description": "The processing state of the account holder.",
"$ref": "#/$defs/AccountProcessingState"
},
"status": {
"description": "The status of the account holder.\n>Permitted values: `Active`, `Inactive`, `Suspended`, `Closed`.",
"enum": [
"Active",
"Closed",
"Inactive",
"Suspended"
],
"type": "string"
},
"statusReason": {
"description": "The reason why the status was assigned to the account holder.",
"type": "string"
}
},
"required": [
"status"
],
"type": "object"
},
"AccountPayoutState": {
"properties": {
"allowPayout": {
"description": "Indicates 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.",
"type": "boolean"
},
"disableReason": {
"description": "The 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.",
"type": "string"
},
"disabled": {
"description": "Indicates 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.",
"type": "boolean"
},
"notAllowedReason": {
"x-addedInVersion": "5",
"description": "The 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.",
"type": "string"
},
"payoutLimit": {
"description": "The maximum amount that payouts are limited to. Only applies if payouts are allowed but limited.",
"$ref": "#/$defs/Amount"
},
"tierNumber": {
"x-addedInVersion": "3",
"description": "The payout tier that the account holder occupies.",
"format": "int32",
"type": "integer"
}
},
"type": "object"
},
"AccountProcessingState": {
"properties": {
"disableReason": {
"description": "The reason why processing has been disabled.",
"type": "string"
},
"disabled": {
"description": "Indicates whether the processing of payments is allowed.",
"type": "boolean"
},
"processedFrom": {
"description": "The 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).",
"$ref": "#/$defs/Amount"
},
"processedTo": {
"description": "The 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).",
"$ref": "#/$defs/Amount"
},
"tierNumber": {
"x-addedInVersion": "3",
"description": "The processing tier that the account holder occupies.",
"format": "int32",
"type": "integer"
}
},
"type": "object"
},
"Amount": {
"properties": {
"currency": {
"description": "The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes).",
"maxLength": 3,
"minLength": 3,
"type": "string"
},
"value": {
"description": "The amount of the transaction, in [minor units](https://docs.adyen.com/development-resources/currency-codes).",
"format": "int64",
"type": "integer"
}
},
"required": [
"value",
"currency"
],
"type": "object"
},
"BankAccountDetail": {
"properties": {
"accountNumber": {
"description": "The bank account number (without separators).\n>Refer to [Required information](https://docs.adyen.com/marketplaces-and-platforms/classic/verification-process/required-information) for details on field requirements.",
"type": "string"
},
"accountType": {
"description": "The type of bank account.\nOnly applicable to bank accounts held in the USA.\nThe permitted values are: `checking`, `savings`.\n\n>Refer to [Required information](https://docs.adyen.com/marketplaces-and-platforms/classic/verification-process/required-information) for details on field requirements.",
"type": "string"
},
"bankAccountName": {
"description": "The name of the bank account.",
"type": "string"
},
"bankAccountReference": {
"x-addedInVersion": "5",
"description": "Merchant reference to the bank account.",
"type": "string"
},
"bankAccountUUID": {
"description": "The unique identifier (UUID) of the Bank Account.\n>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.\n\n>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.\n\n>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.\n\n>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.\n",
"type": "string"
},
"bankBicSwift": {
"description": "The bank identifier code.\n>Refer to [Required information](https://docs.adyen.com/marketplaces-and-platforms/classic/verification-process/required-information) for details on field requirements.",
"type": "string"
},
"bankCity": {
"description": "The city in which the bank branch is located.\n\n>Refer to [Required information](https://docs.adyen.com/marketplaces-and-platforms/classic/verification-process/required-information) for details on field requirements.",
"type": "string"
},
"bankCode": {
"description": "The bank code of the banking institution with which the bank account is registered.\n\n>Refer to [Required information](https://docs.adyen.com/marketplaces-and-platforms/classic/verification-process/required-information) for details on field requirements.",
"type": "string"
},
"bankName": {
"description": "The name of the banking institution with which the bank account is held.\n\n>Refer to [Required information](https://docs.adyen.com/marketplaces-and-platforms/classic/verification-process/required-information) for details on field requirements.",
"type": "string"
},
"branchCode": {
"description": "The 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:\n* United States - Routing number\n* United Kingdom - Sort code\n* Germany - Bankleitzahl\n>Refer to [Required information](https://docs.adyen.com/marketplaces-and-platforms/classic/verification-process/required-information) for details on field requirements.",
"type": "string"
},
"checkCode": {
"description": "The check code of the bank account.\n\n>Refer to [Required information](https://docs.adyen.com/marketplaces-and-platforms/classic/verification-process/required-information) for details on field requirements.",
"type": "string"
},
"countryCode": {
"description": "The two-letter country code in which the bank account is registered.\n>The permitted country codes are defined in ISO-3166-1 alpha-2 (e.g. 'NL').\n\n>Refer to [Required information](https://docs.adyen.com/marketplaces-and-platforms/classic/verification-process/required-information) for details on field requirements.",
"type": "string"
},
"currencyCode": {
"description": "The currency in which the bank account deals.\n>The permitted currency codes are defined in ISO-4217 (e.g. 'EUR').\n",
"type": "string"
},
"iban": {
"description": "The international bank account number.\n>The IBAN standard is defined in ISO-13616.\n\n>Refer to [Required information](https://docs.adyen.com/marketplaces-and-platforms/classic/verification-process/required-information) for details on field requirements.",
"type": "string"
},
"ownerCity": {
"description": "The city of residence of the bank account owner.\n>Refer to [Required information](https://docs.adyen.com/marketplaces-and-platforms/classic/verification-process/required-information) for details on field requirements.",
"type": "string"
},
"ownerCountryCode": {
"description": "The country code of the country of residence of the bank account owner.\n>The permitted country codes are defined in ISO-3166-1 alpha-2 (e.g. 'NL').\n\n>Refer to [Required information](https://docs.adyen.com/marketplaces-and-platforms/classic/verification-process/required-information) for details on field requirements.",
"type": "string"
},
"ownerDateOfBirth": {
"deprecated": true,
"description": "The date of birth of the bank account owner.\nThe date should be in ISO-8601 format yyyy-mm-dd (e.g. 2000-01-31).",
"type": "string"
},
"ownerHouseNumberOrName": {
"description": "The house name or number of the residence of the bank account owner.\n>Refer to [Required information](https://docs.adyen.com/marketplaces-and-platforms/classic/verification-process/required-information) for details on field requirements.",
"type": "string"
},
"ownerName": {
"description": "The name of the bank account owner.\n>Refer to [Required information](https://docs.adyen.com/marketplaces-and-platforms/classic/verification-process/required-information) for details on field requirements.",
"type": "string"
},
"ownerNationality": {
"description": "The country code of the country of nationality of the bank account owner.\n>The permitted country codes are defined in ISO-3166-1 alpha-2 (e.g. 'NL').\n\n>Refer to [Required information](https://docs.adyen.com/marketplaces-and-platforms/classic/verification-process/required-information) for details on field requirements.",
"type": "string"
},
"ownerPostalCode": {
"description": "The postal code of the residence of the bank account owner.\n>Refer to [Required information](https://docs.adyen.com/marketplaces-and-platforms/classic/verification-process/required-information) for details on field requirements.",
"type": "string"
},
"ownerState": {
"description": "The state of residence of the bank account owner.\n>Refer to [Required information](https://docs.adyen.com/marketplaces-and-platforms/classic/verification-process/required-information) for details on field requirements.",
"type": "string"
},
"ownerStreet": {
"description": "The street name of the residence of the bank account owner.\n>Refer to [Required information](https://docs.adyen.com/marketplaces-and-platforms/classic/verification-process/required-information) for details on field requirements.",
"type": "string"
},
"primaryAccount": {
"description": "If set to true, the bank account is a primary account.",
"type": "boolean"
},
"taxId": {
"description": "The tax ID number.\n\n>Refer to [Required information](https://docs.adyen.com/marketplaces-and-platforms/classic/verification-process/required-information) for details on field requirements.",
"type": "string"
},
"urlForVerification": {
"description": "The URL to be used for bank account verification.\nThis may be generated on bank account creation.\n\n>Refer to [Required information](https://docs.adyen.com/marketplaces-and-platforms/classic/verification-process/required-information) for details on field requirements.",
"type": "string"
}
},
"type": "object"
},
"BusinessDetails": {
"properties": {
"doingBusinessAs": {
"description": "The registered name of the company (if it differs from the legal name of the company).",
"type": "string"
},
"legalBusinessName": {
"description": "The legal name of the company.",
"type": "string"
},
"listedUltimateParentCompany": {
"description": "Information about the parent public company. Required if the account holder is 100% owned by a publicly listed company.",
"items": {
"$ref": "#/$defs/UltimateParentCompany"
},
"type": "array"
},
"registrationNumber": {
"x-addedInVersion": "4",
"description": "The registration number of the company.",
"type": "string"
},
"shareholders": {
"description": "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](https://docs.adyen.com/marketplaces-and-platforms/classic/verification-process#identify-ubos).",
"items": {
"$ref": "#/$defs/ShareholderContact"
},
"type": "array"
},
"signatories": {
"description": "Signatories associated with the company.\nEach array entry should represent one signatory.",
"items": {
"$ref": "#/$defs/SignatoryContact"
},
"type": "array"
},
"stockExchange": {
"x-addedInVersion": "6",
"description": "Market Identifier Code (MIC).",
"type": "string"
},
"stockNumber": {
"x-addedInVersion": "6",
"description": "International Securities Identification Number (ISIN).",
"type": "string"
},
"stockTicker": {
"x-addedInVersion": "6",
"description": "Stock Ticker symbol.",
"type": "string"
},
"taxId": {
"description": "The tax ID of the company.",
"type": "string"
}
},
"type": "object"
},
"ErrorFieldType": {
"properties": {
"errorCode": {
"description": "The validation error code.",
"format": "int32",
"type": "integer"
},
"errorDescription": {
"description": "A description of the validation error.",
"type": "string"
},
"fieldType": {
"description": "The type of error field.",
"$ref": "#/$defs/FieldType"
}
},
"type": "object"
},
"FieldType": {
"properties": {
"field": {
"description": "The full name of the property.",
"type": "string"
},
"fieldName": {
"description": "The type of the field.",
"enum": [
"accountCode",
"accountHolderCode",
"accountHolderDetails",
"accountNumber",
"accountStateType",
"accountStatus",
"accountType",
"address",
"balanceAccount",
"balanceAccountActive",
"balanceAccountCode",
"balanceAccountId",
"bankAccount",
"bankAccountCode",
"bankAccountName",
"bankAccountUUID",
"bankBicSwift",
"bankCity",
"bankCode",
"bankName",
"bankStatement",
"branchCode",
"businessContact",
"cardToken",
"checkCode",
"city",
"companyRegistration",
"constitutionalDocument",
"controller",
"country",
"countryCode",
"currency",
"currencyCode",
"dateOfBirth",
"description",
"destinationAccountCode",
"document",
"documentContent",
"documentExpirationDate",
"documentIssuerCountry",
"documentIssuerState",
"documentName",
"documentNumber",
"documentType",
"doingBusinessAs",
"drivingLicence",
"drivingLicenceBack",
"drivingLicenceFront",
"drivingLicense",
"email",
"firstName",
"formType",
"fullPhoneNumber",
"gender",
"hopWebserviceUser",
"houseNumberOrName",
"iban",
"idCard",
"idCardBack",
"idCardFront",
"idNumber",
"identityDocument",
"individualDetails",
"infix",
"jobTitle",
"lastName",
"lastReviewDate",
"legalArrangement",
"legalArrangementCode",
"legalArrangementEntity",
"legalArrangementEntityCode",
"legalArrangementLegalForm",
"legalArrangementMember",
"legalArrangementMembers",
"legalArrangementName",
"legalArrangementReference",
"legalArrangementRegistrationNumber",
"legalArrangementTaxNumber",
"legalArrangementType",
"legalBusinessName",
"legalEntity",
"legalEntityType",
"logo",
"merchantAccount",
"merchantCategoryCode",
"merchantHouseNumber",
"merchantReference",
"microDeposit",
"name",
"nationality",
"originalReference",
"ownerCity",
"ownerCountryCode",
"ownerDateOfBirth",
"ownerHouseNumberOrName",
"ownerName",
"ownerPostalCode",
"ownerState",
"ownerStreet",
"passport",
"passportNumber",
"payoutMethod",
"payoutMethodCode",
"payoutSchedule",
"pciSelfAssessment",
"personalData",
"phoneCountryCode",
"phoneNumber",
"postalCode",
"primaryCurrency",
"reason",
"registrationNumber",
"returnUrl",
"schedule",
"shareholder",
"shareholderCode",
"shareholderCodeAndSignatoryCode",
"shareholderCodeOrSignatoryCode",
"shareholderType",
"shareholderTypes",
"shopperInteraction",
"signatory",
"signatoryCode",
"socialSecurityNumber",
"sourceAccountCode",
"splitAccount",
"splitConfigurationUUID",
"splitCurrency",
"splitValue",
"splits",
"stateOrProvince",
"status",
"stockExchange",
"stockNumber",
"stockTicker",
"store",
"storeDetail",
"storeName",
"storeReference",
"street",
"taxId",
"tier",
"tierNumber",
"transferCode",
"ultimateParentCompany",
"ultimateParentCompanyAddressDetails",
"ultimateParentCompanyAddressDetailsCountry",
"ultimateParentCompanyBusinessDetails",
"ultimateParentCompanyBusinessDetailsLegalBusinessName",
"ultimateParentCompanyBusinessDetailsRegistrationNumber",
"ultimateParentCompanyCode",
"ultimateParentCompanyStockExchange",
"ultimateParentCompanyStockNumber",
"ultimateParentCompanyStockNumberOrStockTicker",
"ultimateParentCompanyStockTicker",
"unknown",
"value",
"verificationType",
"virtualAccount",
"visaNumber",
"webAddress",
"year"
],
"type": "string"
},
"shareholderCode": {
"description": "The code of the shareholder that the field belongs to. If empty, the field belongs to an account holder.",
"type": "string"
}
},
"type": "object"
},
"IndividualDetails": {
"properties": {
"name": {
"description": "The name of the individual.\n>Make sure your account holder registers using the name shown on their Photo ID.",
"$ref": "#/$defs/ViasName"
},
"personalData": {
"description": "Personal information of the individual.",
"$ref": "#/$defs/ViasPersonalData"
}
},
"type": "object"
},
"KYCCheckResult": {
"properties": {
"checks": {
"description": "A list of the checks and their statuses.",
"items": {
"$ref": "#/$defs/KYCCheckStatusData"
},
"type": "array"
}
},
"type": "object"
},
"KYCCheckStatusData": {
"properties": {
"requiredFields": {
"description": "A list of the fields required for execution of the check.",
"items": {
"type": "string"
},
"type": "array"
},
"status": {
"description": "The status of the check.\n\nPossible values: **AWAITING_DATA** , **DATA_PROVIDED**, **FAILED**, **INVALID_DATA**, **PASSED**, **PENDING**, **RETRY_LIMIT_REACHED**.",
"enum": [
"AWAITING_DATA",
"DATA_PROVIDED",
"FAILED",
"INVALID_DATA",
"PASSED",
"PENDING",
"PENDING_REVIEW",
"RETRY_LIMIT_REACHED",
"UNCHECKED"
],
"type": "string"
},
"summary": {
"description": "A summary of the execution of the check.",
"$ref": "#/$defs/KYCCheckSummary"
},
"type": {
"description": "The type of check.\n\nPossible values:\n\n * **BANK_ACCOUNT_VERIFICATION**: Used in v5 and earlier. Replaced by **PAYOUT_METHOD_VERIFICATION** in v6 and later.\n\n * **COMPANY_VERIFICATION**\n\n * **CARD_VERIFICATION**\n\n* **IDENTITY_VERIFICATION**\n\n* **LEGAL_ARRANGEMENT_VERIFICATION**\n\n* **NONPROFIT_VERIFICATION**\n\n * **PASSPORT_VERIFICATION**\n\n* **PAYOUT_METHOD_VERIFICATION**: Used in v6 and later.\n\n* **PCI_VERIFICATION**",
"enum": [
"BANK_ACCOUNT_VERIFICATION",
"CARD_VERIFICATION",
"COMPANY_VERIFICATION",
"IDENTITY_VERIFICATION",
"LEGAL_ARRANGEMENT_VERIFICATION",
"NONPROFIT_VERIFICATION",
"PASSPORT_VERIFICATION",
"PAYOUT_METHOD_VERIFICATION",
"PCI_VERIFICATION"
],
"type": "string"
}
},
"required": [
"type",
"status"
],
"type": "object"
},
"KYCCheckSummary": {
"properties": {
"kycCheckCode": {
"x-addedInVersion": "5",
"description": "The code of the check. For possible values, refer to [Verification codes](https://docs.adyen.com/marketplaces-and-platforms/classic/verification-process/verification-codes).",
"format": "int32",
# --- truncated at 32 KB (61 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/adyen/refs/heads/main/json-schema/adyen-create-account-holder-response-schema.json
Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/adyen-create-account-holder-response"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.