---
title: "Get the balances of an account holder"
method: POST
path: "/accountHolderBalance"
tags: ["General"]
---

# Get the balances of an account holder

`POST /accountHolderBalance`

Returns the account balances of an account holder. An account's balances are organized according by currencies. This mean that an account may have multiple balances: one for each currency.

## Request body

- AccountHolderBalanceRequest
  - `accountHolderCode` string, required — The code of the Account Holder of which to retrieve the balance.

## Response `200`

OK - the request has succeeded.

- AccountHolderBalanceResponse
  - `balancePerAccount` AccountDetailBalanceWrapper[] — A list of each account and their balances.
    - `AccountDetailBalance` AccountDetailBalance
      - `accountCode` string — The code of the account that holds the balance.
      - `detailBalance` DetailBalance
        - `balance` AmountWrapper[] — The list of balances held by the account.
          - `Amount` Amount
            - `currency` string, required — The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes).
            - `value` integer, required — The amount of the transaction, in [minor units](https://docs.adyen.com/development-resources/currency-codes).
        - `pendingBalance` AmountWrapper[] — The list of pending balances held by the account.
          - `Amount` Amount
            - `currency` string, required — The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes).
            - `value` integer, required — The amount of the transaction, in [minor units](https://docs.adyen.com/development-resources/currency-codes).
  - `pspReference` string — The reference of a request. Can be used to uniquely identify the request.
  - `resultCode` string — The result code.
  - `submittedAsync` boolean — Indicates whether the request is processed asynchronously. Depending on the request's platform settings, the following scenarios may be applied: * **true**: The request is queued and will be executed when the providing service is available in the order in which the requests are received. * **false**: The processing of the request is immediately attempted; it may result in an error if the providing service is unavailable.
  - `totalBalance` DetailBalance
    - `balance` AmountWrapper[] — The list of balances held by the account.
      - `Amount` Amount
        - `currency` string, required — The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes).
        - `value` integer, required — The amount of the transaction, in [minor units](https://docs.adyen.com/development-resources/currency-codes).
    - `pendingBalance` AmountWrapper[] — The list of pending balances held by the account.
      - `Amount` Amount
        - `currency` string, required — The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes).
        - `value` integer, required — The amount of the transaction, in [minor units](https://docs.adyen.com/development-resources/currency-codes).

## Other responses

- `202` — Accepted - the request has been accepted for processing, but the processing has not been completed.
- `400` — Bad Request - a problem reading or understanding the request.
- `401` — Unauthorized - authentication required.
- `403` — Forbidden - insufficient permissions to process the request.
- `422` — Unprocessable Entity - a request validation error.
- `500` — Internal Server Error - the server could not process the request.

---

[API](https://skmtc.net/adyen/apis/fundservice.md) · [All operations](https://skmtc.net/adyen/apis/fundservice/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/adyen/fundservice/revisions/9b4819139946/schema)