---
title: "Get balance"
method: GET
path: "/balances/{balanceId}"
tags: ["Balances API"]
---

# Get balance

`GET /balances/{balanceId}`

## Request

- Base URL: `https://api.mollie.com/v2`
- URL: `https://api.mollie.com/v2/balances/{balanceId}`
- 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`

When processing payments with Mollie, we put all pending funds — usually minus Mollie fees — on a balance. Once you have linked a bank account to your Mollie account, we can pay out your balance towards this bank account.

With the Balances API you can retrieve your current balance. The response includes two amounts:

* The *pending amount*. These are payments that have been marked as `paid`, but are not yet available on your balance.
* The *available amount*. This is the amount that you can get paid out to your bank account, or use for refunds.

With instant payment methods like iDEAL, payments are moved to the available balance instantly. With slower payment methods, like credit card for example, it can take a few days before the funds are available on your balance. These funds will be shown under the *pending amount* in the meanwhile.

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

## Query parameters

- `testmode` boolean

## Response `200`

The balance object.

- object
  - `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.
    - `documentation` 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.

## Other responses

- `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)