Adyen · Schema

AccountHolderDetails

PaymentsFinancial-ServicesFintech

Properties

Name Type Description
address object The address of the account holder.
bankAccountDetails array 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/class
bankAggregatorDataReference string The opaque reference value returned by the Adyen API during bank account login.
businessDetails object Details about the business or nonprofit account holder. Required when creating an account holder with `legalEntity` **Business** or **NonProfit**.
email string The email address of the account holder.
fullPhoneNumber string The 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"
individualDetails object Details about the individual account holder. Required when creating an account holder with `legalEntity` **Individual**.
lastReviewDate string Date when you last reviewed the account holder's information, in ISO-8601 YYYY-MM-DD format. For example, **2020-01-31**.
legalArrangements array An array containing information about the account holder's [legal arrangements](https://docs.adyen.com/marketplaces-and-platforms/classic/verification-process/legal-arrangements).
merchantCategoryCode string The 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).
metadata object A 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
payoutMethods array 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-platfor
principalBusinessAddress object The principal business address of the account holder.
storeDetails array 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-
webAddress string The URL of the website of the account holder.
View JSON Schema on GitHub

JSON Schema

adyen-accountholderdetails-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/AccountHolderDetails",
  "title": "AccountHolderDetails",
  "properties": {
    "address": {
      "description": "The address of the account holder.",
      "$ref": "#/components/schemas/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": "#/components/schemas/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": "#/components/schemas/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": "#/components/schemas/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": "#/components/schemas/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": "#/components/schemas/PayoutMethod"
      },
      "type": "array"
    },
    "principalBusinessAddress": {
      "description": "The principal business address of the account holder.",
      "$ref": "#/components/schemas/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": "#/components/schemas/StoreDetail"
      },
      "type": "array"
    },
    "webAddress": {
      "description": "The URL of the website of the account holder.",
      "type": "string"
    }
  },
  "required": [
    "address"
  ],
  "type": "object"
}

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.
All 92 tools

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/adyen-accountholderdetails"
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 email required.

A second provider on the same verified email joins the account you already have.