---
title: "Get all balance accounts of an account holder"
method: GET
path: "/accountHolders/{id}/balanceAccounts"
tags: ["Account holders"]
---

# Get all balance accounts of an account holder

`GET /accountHolders/{id}/balanceAccounts`

Returns a paginated list of the balance accounts associated with an account holder. To fetch multiple pages, use the query parameters. 

For example, to limit the page to 5 balance accounts and skip the first 10, use `/accountHolders/{id}/balanceAccounts?limit=5&offset=10`.

## Path parameters

- `id` string, required

## Query parameters

- `offset` integer
- `limit` integer

## Response `200`

OK - the request has succeeded.

- PaginatedBalanceAccountsResponse
  - `balanceAccounts` BalanceAccountBase[], required — List of balance accounts.
    - `accountHolderId` string, required — The unique identifier of the [account holder](https://docs.adyen.com/api-explorer/#/balanceplatform/latest/post/accountHolders__resParam_id) associated with the balance account.
    - `defaultCurrencyCode` string — The default three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes) of the balance account. The default value is **EUR**. > After a balance account is created, you cannot change its default currency.
    - `description` string — A human-readable description of the balance account, maximum 300 characters. You can use this parameter to distinguish between multiple balance accounts under an account holder.
    - `id` string, required — The unique identifier of the balance account.
    - `metadata` object — A set of key and value pairs for general use. The keys do not have specific names and may be used for storing miscellaneous data as desired. > Note that during an update of metadata, the omission of existing key-value pairs will result in the deletion of those key-value pairs.
    - `migratedAccountCode` string — The unique identifier of the account of the migrated account holder in the classic integration.
    - `platformPaymentConfiguration` PlatformPaymentConfiguration
      - `salesDayClosingTime` string, time — Specifies at what time a [sales day](https://docs.adyen.com/marketplaces-and-platforms/settle-funds/sales-day-settlement#sales-day) ends. Possible values: Time in **"HH:MM"** format. **HH** ranges from **00** to **07**. **MM** must be **00**. Default value: **"00:00"**.
      - `settlementDelayDays` integer — Specifies after how many business days the funds in a [settlement batch](https://docs.adyen.com/marketplaces-and-platforms/settle-funds/sales-day-settlement#settlement-batch) are made available. Possible values: **0** to **10**, or **null**. * Setting this value to an integer enables [Sales day settlement](https://docs.adyen.com/marketplaces-and-platforms/settle-funds/sales-day-settlement). * Setting this value to **null** enables [Pass-through settlement](https://docs.adyen.com/marketplaces-and-platforms/settle-funds/pass-through-settlement). Default value: **null**.
    - `reference` string — Your reference for the balance account, maximum 150 characters.
    - `status` 'active' | 'closed' | 'inactive' | 'suspended' — The status of the balance account, set to **active** by default.
    - `timeZone` string — The time zone of the balance account. For example, **Europe/Amsterdam**. Defaults to the time zone of the account holder if no time zone is set. For possible values, see the [list of time zone codes](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones).
  - `hasNext` boolean, required — Indicates whether there are more items on the next page.
  - `hasPrevious` boolean, required — Indicates whether there are more items on the previous page.

## Other responses

- `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.dev/adyen/apis/balanceplatformservice.md) · [All operations](https://skmtc.dev/adyen/apis/balanceplatformservice/llms.txt) · [OpenAPI document](https://skmtc.dev/adyen/apis/balanceplatformservice/revisions/78e297a2eb6f?raw)
