Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Adyen Account API

The Account API from Adyen — 7 operation(s) for account.

Adyen Account API is one of 202 APIs that Adyen publishes on the APIs.io network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification.

Tagged areas include Account. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an AsyncAPI specification.

This API exposes 7 operations across 7 paths, and defines 72 schemas. It is described by OpenAPI 3.1.0, at version 6.

Requests are made against a single base URL, https://cal-test.adyen.com/cal/services/Account/v6.

7 operations 7 paths 72 schemas 1 GET6 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
6
Base URL
https://cal-test.adyen.com
Authentication
API Key, HTTP Basic
Terms of Service
Resource Areas
1

Authentication & Security 2

Adyen Account API declares 2 security schemes for authenticating requests. An API key is passed in the header as X-API-Key (ApiKeyAuth). It accepts HTTP basic authentication (BasicAuth).

Paths & Operations 7

Across 7 paths, the API surfaces 7 operations — 1 GET, 6 POST. Each is listed below with its method, path, parameters, and response codes.

Account 7
POST
/createAccount
Adyen Create an Account
post-createAccount body → 200202400401403422500
POST
/createAccountHolder
Adyen Create an Account Holder
post-createAccountHolder body → 200400401403422500
POST
/getAccountHolder
Adyen Get an Account Holder
post-getAccountHolder body → 200202400401403422500
POST
/updateAccount
Adyen Update an Account
post-updateAccount body → 200202400401403422500
POST
/updateAccountHolder
Adyen Update an Account Holder
post-updateAccountHolder body → 200202400401403422500
POST
/updateAccountHolderState
Adyen Update Payout or Processing State
post-updateAccountHolderState body → 200202400401403422500
GET
/balancePlatforms/{id}/accountHolders
Adyen Get All Account Holders Under a Balance Platform
get-balancePlatforms-id-accountHolders 3 params → 200400401403422500

Schemas 72

The contract defines 72 schemas that model the data the API accepts and returns. The most detailed are BankAccountDetail (26 properties), AccountHolderDetails (15 properties), StoreDetail (15 properties), GetAccountHolderResponse (14 properties). Each schema is shown below with its type and property counts.

LegalArrangementEntityDetail
object
11 properties
AccountPayoutState
object
6 properties
KYCLegalArrangementCheckResult
object
2 properties
BankAccountDetail
object
26 properties
SignatoryContact
object
10 properties
Address
object
6 properties 5 required
GetAccountHolderRequest
object
3 properties
PayoutScheduleResponse
object
2 properties
KYCLegalArrangementEntityCheckResult
object
3 properties
AccountHolderDetails
object
15 properties 1 required
AccountHolderStatus
object
5 properties 1 required
KYCShareholderCheckResult
object
4 properties
VerificationError
object
6 properties
StoreDetail
object
15 properties 3 required
AccountHolder
object
13 properties 2 required
Account
object
10 properties
CapabilitySettings
object
5 properties
CreateAccountRequest
object
8 properties 1 required
ViasPhoneNumber
object
3 properties
ContactDetails
object
4 properties 3 required
MigratedShareholders
object
2 properties
UltimateParentCompany
object
3 properties
RestServiceError
object
9 properties 5 required
MigrationData
object
7 properties
IndividualDetails
object
2 properties
UltimateParentCompanyBusinessDetails
object
5 properties
KYCSignatoryCheckResult
object
2 properties
KYCCheckResult
object
1 property
LegalArrangementDetail
object
9 properties 3 required
VerificationError-recursive
object
5 properties
ViasName
object
4 properties
RemediatingAction
object
2 properties
AccountEvent
object
3 properties
CapabilityProblemEntity
object
4 properties
BusinessDetails
object
10 properties
KYCCheckSummary
object
2 properties
InvalidField
object
3 properties 3 required
ShareholderContact
object
11 properties
VerificationDeadline
object
3 properties 2 required
JSONObject
object
KYCVerificationResult
object
7 properties
ErrorFieldType
object
3 properties
CapabilityProblemEntity-recursive
object
3 properties
PayoutMethod
object
5 properties 3 required
UpdateAccountHolderRequest
object
7 properties 1 required
CreateAccountHolderRequest
object
8 properties 3 required
ServiceError
object
5 properties
CreateAccountResponse
object
12 properties
FieldType
object
3 properties
UpdateAccountHolderResponse
object
11 properties
Amount
object
2 properties 2 required
MigratedStores
object
4 properties
ViasAddress
object
6 properties 1 required
ViasPersonalData
object
3 properties
CapabilityProblem
object
2 properties
AccountSupportingEntityCapability
object
7 properties
UpdateAccountRequest
object
7 properties 1 required
UpdateAccountHolderStateRequest
object
4 properties 3 required
MigratedAccounts
object
2 properties
Phone
object
2 properties 2 required
PersonalDocumentData
object
5 properties 1 required
KYCUltimateParentCompanyCheckResult
object
2 properties
GetAccountHolderStatusResponse
object
5 properties
AccountHolderCapability
object
10 properties
KYCCheckStatusData
object
4 properties 2 required
PaginatedAccountHoldersResponse
object
3 properties 3 required
GetAccountHolderResponse
object
14 properties
AccountProcessingState
object
5 properties
KYCPayoutMethodCheckResult
object
2 properties
UpdatePayoutScheduleRequest
object
3 properties 1 required
CreateAccountHolderResponse
object
12 properties
UpdateAccountResponse
object
10 properties 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

adyen-account-api-openapi.yml Raw ↑

Other APIs Adyen publishes across the network.

Adyen acceptDispute API
Adyen accountHolderBalance API
Adyen accountHolders API
Adyen accountHolderTransactionList API
Adyen Accounting Notifications API
Adyen Accounts API
Adyen adjustAuthorisation API
Adyen Admin API
Adyen Amount API
Adyen Apple API
Adyen applePay API
Adyen Arrangements API