Adyen Accounts API

The Accounts API from Adyen — 17 operation(s) for accounts.

Operations 16

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /accountHolders Create an account holder · Adyen Create an Account Holder #
Ask an LLM
“How do I create an account holder for a legal entity on my balance platform?”
“Can I attach my own reference and metadata to a new account holder?”
Tell an agent
Create an account holder for legal entity {legalEntity}.
Create an account holder for legal entity {legalEntity} with reference {ref}.
GET /accountHolders/{id} Get an account holder · Adyen Get an Account Holder #
Ask an LLM
“What capabilities and status does an account holder have?”
“Can I look up an account holder by its ID?”
Tell an agent
Get account holder {id}.
Show the status and capabilities of account holder {id}.
PATCH /accountHolders/{id} Update an account holder · Adyen Update an Account Holder #
Ask an LLM
“Can I change an account holder's primary balance account?”
“Are fields I leave out of an account holder update kept as they were?”
Tell an agent
Set the primary balance account of account holder {id} to {balanceAccount}.
Change the status of account holder {id} to {status}.
GET /accountHolders/{id}/balanceAccounts List an account holder's balance accounts · Adyen Get All Balance Accounts of an Account Holder #
Ask an LLM
“Which balance accounts belong to a given account holder?”
“Can I page through an account holder's balance accounts with offset and limit?”
Tell an agent
List the balance accounts of account holder {id}.
Show {limit} balance accounts of account holder {id}, skipping the first {offset}.
GET /accountHolders/{id}/taxForms Generate a US tax form for an account holder · Adyen Get a Tax Form #
Ask an LLM
“Can I get a US tax form like a 1099 for an account holder?”
“Which year and form type do I need to request an account holder's tax form?”
Tell an agent
Get the {formType} tax form for {year} for account holder {id}.
Generate account holder {id}'s {year} {formType} form.
POST /balanceAccounts Create a balance account · Adyen Create a Balance Account #
Ask an LLM
“How do I open a balance account to hold an account holder's funds?”
“Can I set a default currency when creating a balance account?”
Tell an agent
Create a balance account for account holder {holder}.
Open a {currency} balance account for account holder {holder}.
GET /balanceAccounts/{balanceAccountId}/sweeps List sweeps on a balance account · Adyen Get All Sweeps for a Balance Account #
Ask an LLM
“Which automatic sweeps are configured on a balance account?”
“Can I page through a balance account's sweeps?”
Tell an agent
List the sweeps configured on balance account {ba}.
Show {limit} sweeps for balance account {ba}.
POST /balanceAccounts/{balanceAccountId}/sweeps Schedule a sweep of funds · Adyen Create a Sweep #
Ask an LLM
“Can I automatically move funds out of a balance account on a schedule?”
“Is it possible to trigger a sweep only when the balance passes a threshold?”
Tell an agent
Create a {currency} sweep on balance account {ba} to {counterparty} on schedule {schedule}.
Set up a sweep on {ba} in {currency} to {counterparty} every {schedule} when the balance exceeds {trigger}.
DELETE /balanceAccounts/{balanceAccountId}/sweeps/{sweepId} Delete a sweep · Adyen Delete a Sweep #
Ask an LLM
“Can I stop an automatic sweep permanently?”
“What happens to scheduled fund movements when I delete a sweep?”
Tell an agent destructive · confirm first
Delete sweep {sweep} from balance account {ba}.
Remove the automatic sweep {sweep} on {ba}.
GET /balanceAccounts/{balanceAccountId}/sweeps/{sweepId} Get a sweep · Adyen Get a Sweep #
Ask an LLM
“What schedule and counterparty does a specific sweep use?”
“Can I check whether one sweep is still active?”
Tell an agent
Get sweep {sweep} on balance account {ba}.
Show the schedule of sweep {sweep} for balance account {ba}.
PATCH /balanceAccounts/{balanceAccountId}/sweeps/{sweepId} Update a sweep · Adyen Update a Sweep #
Ask an LLM
“Can I change the schedule or amount of an existing sweep?”
“Can I pause a sweep without deleting it?”
Tell an agent
Change the schedule of sweep {sweep} on balance account {ba} to {schedule}.
Set the status of sweep {sweep} on {ba} to {status}.
GET /balanceAccounts/{id} Get a balance account and its balances · Adyen Get a Balance Account #
Ask an LLM
“What is the current balance on a balance account?”
“Does the balance account response include non-default currencies?”
Tell an agent
Get balance account {id} with its balances.
Show how much money is in balance account {id}.
PATCH /balanceAccounts/{id} Update a balance account · Adyen Update a Balance Account #
Ask an LLM
“Can I change the description or reference on a balance account?”
“Can I close or suspend a balance account by changing its status?”
Tell an agent
Update the description of balance account {id} to {description}.
Change the status of balance account {id} to {status}.
GET /balanceAccounts/{id}/paymentInstruments List payment instruments on a balance account · Adyen Get Payment Instruments Linked to a Balance Account #
Ask an LLM
“Which cards or payment instruments are linked to a balance account?”
“Can I list only active payment instruments for a balance account?”
Tell an agent
List the payment instruments linked to balance account {id}.
Show {status} payment instruments on balance account {id}.
GET /grantAccounts/{id} Get a grant account · Adyen Get a Grant Account #
Ask an LLM
“What details does a grant account hold?”
“Can I look up a grant account by its ID?”
Tell an agent
Get grant account {id}.
Show the details of grant account {id}.
POST /validateBankAccountIdentification Validate bank account details · Adyen Validate a Bank Account #
Ask an LLM
“Can I check that bank account details are valid before making a transfer?”
“Is there a way to validate an IBAN before creating a transfer instrument?”
Tell an agent
Validate the bank account identification {account}.
Check whether bank details {account} are valid before I send money.

Documentation

📖
Documentation
https://docs.adyen.com/marketplaces-and-platforms/classic/configure-notifications/
📖
Documentation
https://docs.adyen.com/api-explorer/Account/6/overview
📖
Documentation
https://docs.adyen.com/development-resources/webhooks/
📖
Documentation
https://docs.adyen.com/api-explorer/BalanceControl/1/overview
📖
Documentation
https://docs.adyen.com/api-explorer/BinLookup/52/overview
📖
Documentation
https://docs.adyen.com/api-explorer/Checkout/71/overview
📖
Documentation
https://docs.adyen.com/api-explorer/balanceplatform/2/overview
📖
Documentation
https://docs.adyen.com/api-explorer/balanceplatform-webhooks/1/overview
📖
Documentation
https://docs.adyen.com/development-resources/data-protection-api/
📖
Documentation
https://docs.adyen.com/risk-management/disputes-api
📖
Documentation
https://docs.adyen.com/marketplaces-and-platforms/classic/fund-transfer/
📖
Documentation
https://docs.adyen.com/marketplaces-and-platforms/collect-verification-details/hosted/
📖
Documentation
https://docs.adyen.com/marketplaces-and-platforms/legal-entity-management-api/
📖
Documentation
https://docs.adyen.com/api-explorer/Management/3/overview
📖
Documentation
https://docs.adyen.com/api-explorer/management-webhooks/3/overview
📖
Documentation
https://docs.adyen.com/marketplaces-and-platforms/classic/notifications
📖
Documentation
https://docs.adyen.com/point-of-sale/design-your-integration/notifications/
📖
Documentation
https://docs.adyen.com/online-payments/
📖
Documentation
https://docs.adyen.com/online-payments/online-payouts
📖
Documentation
https://docs.adyen.com/point-of-sale/design-your-integration/terminal-api/
📖
Documentation
https://docs.adyen.com/online-payments/tokenization
📖
Documentation
https://docs.adyen.com/api-explorer/report-webhooks/1/overview
📖
Documentation
https://docs.adyen.com/payment-methods/gift-cards/stored-value-api/
📖
Documentation
https://docs.adyen.com/point-of-sale/design-your-integration/terminal-api/terminal-api-reference/
📖
Documentation
https://docs.adyen.com/development-resources/testing/create-test-cards
📖
Documentation
https://docs.adyen.com/marketplaces-and-platforms/business-accounts/transactions/transaction-webhooks/
📖
Documentation
https://docs.adyen.com/api-explorer/transfer-webhooks/3/overview
📖
Documentation
https://docs.adyen.com/marketplaces-and-platforms/payout-to-users/on-demand-payouts
📖
Documentation
https://docs.adyen.com/development-resources/webhooks

Specifications

Work with this as data

Every API 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 apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • 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 API
curl "https://apis.io/api/v1/apis/adyen-accounts-api"
All apis
curl "https://apis.io/api/v1/apis?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.

OpenAPI Specification

adyen-accounts-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  version: '2'
  x-publicVersion: true
  title: Adyen Configuration Accounts API
  description: The Configuration API enables you to create a platform where you can onboard your users as account holders and create balance accounts, cards, and business accounts.
  termsOfService: https://www.adyen.com/legal/terms-and-conditions
  contact:
    name: Adyen Developer Experience team
    url: https://github.com/Adyen/adyen-openapi
servers:
- url: https://balanceplatform-api-test.adyen.com/bcl/v2
tags:


# --- truncated at 32 KB (163 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/adyen/refs/heads/main/openapi/adyen-accounts-api-openapi.yml