Adyen · Schema

UpdateAccountHolderRequest

UpdateAccountHolderRequest schema from Adyen API

PaymentsFinancial ServicesFintechAgentic CommercePoint-of-SalePayment Processing

Properties

Name Type Description
accountHolderCode string The code of the Account Holder to be updated.
accountHolderDetails object The details to which the Account Holder should be updated. Required if a processingTier is not provided.
description string A description of the account holder, maximum 256 characters. You can use alphanumeric characters (A-Z, a-z, 0-9), white spaces, and underscores `_`.
legalEntity string The legal entity type of the account holder. This determines the information that should be provided in the request. Possible values: **Business**, **Individual**, or **NonProfit**. * If set to **Busi
primaryCurrency string The primary three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes), to which the account holder should be updated.
processingTier integer The processing tier to which the Account Holder should be updated. >The processing tier can not be lowered through this request. >Required if accountHolderDetails are not provided.
verificationProfile string The identifier of the profile that applies to this entity.
View JSON Schema on GitHub

JSON Schema

accounts-update-account-holder-request-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/adyen/refs/heads/main/json-schema/accounts-update-account-holder-request-schema.json",
  "title": "UpdateAccountHolderRequest",
  "description": "UpdateAccountHolderRequest schema from Adyen API",
  "type": "object",
  "properties": {
    "accountHolderCode": {
      "description": "The code of the Account Holder to be updated.",
      "type": "string"
    },
    "accountHolderDetails": {
      "description": "The details to which the Account Holder should be updated.\n\nRequired if a processingTier is not provided.",
      "$ref": "#/components/schemas/AccountHolderDetails"
    },
    "description": {
      "x-addedInVersion": "4",
      "description": "A description of the account holder, maximum 256 characters. You can use alphanumeric characters (A-Z, a-z, 0-9), white spaces, and underscores `_`.",
      "type": "string"
    },
    "legalEntity": {
      "x-addedInVersion": "5",
      "description": "The legal entity type of the account holder. This determines the information that should be provided in the request.\n\nPossible values: **Business**, **Individual**, or **NonProfit**.\n\n* If set to **Business** or **NonProfit**, then `accountHolderDetails.businessDetails` must be provided, with at least one entry in the `accountHolderDetails.businessDetails.shareholders` list.\n\n* If set to **Individual**, then `accountHolderDetails.individualDetails` must be provided.",
      "enum": [
        "Business",
        "Individual",
        "NonProfit",
        "Partnership",
        "PublicCompany"
      ],
      "type": "string"
    },
    "primaryCurrency": {
      "x-addedInVersion": "4",
      "deprecated": true,
      "description": "The primary three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes), to which the account holder should be updated.",
      "type": "string"
    },
    "processingTier": {
      "x-addedInVersion": "3",
      "description": "The processing tier to which the Account Holder should be updated.\n>The processing tier can not be lowered through this request.\n\n>Required if accountHolderDetails are not provided.",
      "format": "int32",
      "type": "integer"
    },
    "verificationProfile": {
      "x-addedInVersion": "6",
      "description": "The identifier of the profile that applies to this entity.",
      "type": "string"
    }
  },
  "required": [
    "accountHolderCode"
  ]
}

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/accounts-update-account-holder-request"
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.