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

# Get balance

`GET /v2/balances/{balanceId}`

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.

## Query parameters

- `testmode` boolean

## Headers

- `idempotency-key` string

## Response `200`

The balance object.

## Other responses

- `404` — No entity with this ID exists.
- `429` — Rate Limit has been reached.

## Changes

> 92 revisions in range; 9 not diffed.

- **2026-07-02** `01ff4e7355c4` — 1 warning
  - added the new `RON` enum value to the `currency/allOf[#/components/schemas/currencies]/` response property for the response status `200`
- **2026-05-19** `7cab62b21830` — 1 info
  - added the non-success response with the status `429`
- **2026-05-12** `ef4b5a97b56a` — 2 info
  - the endpoint scheme security `advancedAccessToken` was added to the API
  - the endpoint scheme security `organizationAccessToken` was removed from the API

[Change history](https://skmtc.dev/mollie/apis/mollie-api/changes/v2/balances/:balanceId/get.md)

---

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