---
title: "List balances"
method: GET
path: "/balances"
tags: ["Balances API"]
---

# List balances

`GET /balances`

## Request

- Base URL: `https://api.mollie.com/v2`
- URL: `https://api.mollie.com/v2/balances`
- Auth: one of:
  - HTTP bearer
  - OAuth 2
    - Authorization code: `https://my.mollie.com/oauth2/authorize`
    - Token URL: `https://api.mollie.com/oauth2/tokens` scopes: `balances.read`

Retrieve a list of the organization's balances, including the primary balance.

The results are paginated.

> 🔑 Access with
>
> [Advanced access token with **balances.read**](/reference/authentication)
>
> [OAuth access with **balances.read**](/reference/authentication)

## Query parameters

- `currency` string, nullable
- `from` string
- `limit` integer, nullable
- `testmode` boolean

## Response `200`

A list of balance objects. For a complete reference of the balance object, refer to the [Get balance endpoint](get-balance) documentation.

- object
  - `count` integer, required: The number of items in this result set. If more items are available, a `_links.next` URL will be present in the result as well. The maximum number of items per result set is controlled by the `limit` property provided in the request. The default limit is 50 items.
  - `_embedded` object, required
    - `balances` object[], required: An array of balance objects. For a complete reference of the balance object, refer to the [Get balance endpoint](get-balance) documentation.
      - `resource` string, required: Indicates the response contains a balance object. Will always contain the string `balance` for this endpoint.
      - `id` string, required: The identifier uniquely referring to this balance.
      - `mode` string, required: Whether this entity was created in live mode or in test mode. Possible values: `live` `test`
      - `createdAt` string, required: The entity's date and time of creation, in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
      - `currency` 'EUR' | 'GBP' | 'CHF' | 'DKK' | 'NOK' | 'PLN' | 'SEK' | 'USD' | 'CZK' | 'HUF' | 'AUD' | 'CAD' | 'RON', required: The balance's ISO 4217 currency code.
      - `description` string, required: The description or name of the balance. Can be used to denote the purpose of the balance.
      - `status` string, required: The status of the balance. Possible values: `active` `inactive`
      - `transferFrequency` string: The frequency with which the available amount on the balance will be settled to the configured transfer destination. Settlements created during weekends or on bank holidays will take place on the next business day. Possible values: `every-day` `daily` `every-monday` `every-tuesday` `every-wednesday` `every-thursday` `every-friday` `monthly` `revenue-day` `never`
      - `transferThreshold` object: The minimum amount configured for scheduled automatic settlements. As soon as the amount on the balance exceeds this threshold, the complete balance will be paid out to the transfer destination according to the configured frequency.
        - `currency` string, required: A three-character ISO 4217 currency code.
        - `value` string, required: A string containing an exact monetary amount in the given currency.
      - `transferReference` string, nullable: The transfer reference set to be included in all the transfers for this balance.
      - `transferDestination` object, nullable: The destination where the available amount will be automatically transferred to according to the configured transfer frequency.
        - `type` string: The default destination of automatic scheduled transfers. Currently only `bank-account` is supported. * `bank-account` — Transfer the balance amount to an external bank account Possible values: `bank-account`
        - `bankAccount` string: The configured bank account number of the beneficiary the balance amount is to be transferred to.
        - `beneficiaryName` string: The full name of the beneficiary the balance amount is to be transferred to.
      - `availableAmount` object, required: The amount directly available on the balance, e.g. `{"currency":"EUR", "value":"100.00"}`.
        - `currency` string, required: A three-character ISO 4217 currency code.
        - `value` string, required: A string containing an exact monetary amount in the given currency.
      - `pendingAmount` object, required: The total amount that is queued to be transferred to your balance. For example, a credit card payment can take a few days to clear.
        - `currency` string, required: A three-character ISO 4217 currency code.
        - `value` string, required: A string containing an exact monetary amount in the given currency.
      - `_links` object, required: An object with several relevant URLs. Every URL object will contain an `href` and a `type` field.
        - `self` object: In v2 endpoints, URLs are commonly represented as objects with an `href` and `type` field.
          - `href` string, required: The actual URL string.
          - `type` string, required: The content type of the page or endpoint the URL points to.
  - `_links` object, required: Links to help navigate through the lists of items. Every URL object will contain an `href` and a `type` field.
    - `self` object, required: The URL to the current set of items.
      - `href` string, required: The actual URL string.
      - `type` string, required: The content type of the page or endpoint the URL points to.
    - `previous` object, nullable, required: The previous set of items, if available.
      - `href` string: The actual URL string.
      - `type` string: The content type of the page or endpoint the URL points to.
    - `next` object, nullable, required: The next set of items, if available.
      - `href` string: The actual URL string.
      - `type` string: The content type of the page or endpoint the URL points to.
    - `documentation` object, required: In v2 endpoints, URLs are commonly represented as objects with an `href` and `type` field.
      - `href` string, required: The actual URL string.
      - `type` string, required: The content type of the page or endpoint the URL points to.

## Other responses

- `400`: The request contains issues. For example, if the specified `from` value is not a valid ID.
- `404`: No entity with this ID exists.
- `429`: Rate Limit has been reached.

---

[API](https://skmtc.dev/mollie/apis/business-operations.md) - [All operations](https://skmtc.dev/mollie/apis/business-operations/llms.txt) - [OpenAPI document](https://skmtc.dev/mollie/apis/business-operations/revisions/d51d76f4e5d9?raw)