Balances API

The Balances API allows you to retrieve real-time as well as historical information about your Mollie balance. This may be useful to for example integrate Mollie into your bookkeeping, or for SaaS providers to enrich the experience they offer their Mollie users. With the Balances API, you can:

• Retrieve your real-time open balance(s)
• Retrieve all balance movements that took place on your balance (e.g. payments, refunds, etc.)
• Retrieve aggregated time-based reports of these balance movements

The Balances API has some overlap with the Settlements API, since the Settlements API allows you to retrieve the fixed list of balance movements that were included in each settlement. Both APIs can be used for accounting and reconciliation purposes, however the Balances API will give you the most complete overview where you don’t have to wait for the execution of the actual Settlement.

For more information, refer to knowledge base.

Note

Due to technical limitations, data from before 1 July 2022 is not available via this API.

Endpoints

Get balance

GET/v2/balances/*balanceId*

Retrieve details of a specific balance.

Get primary balance

GET/v2/balances/primary

Retrieve details of the primary balance.

List balances

GET/v2/balances

Retrieve all the organization’s balances, including the primary balance, ordered from newest to oldest.

Get balance report

GET/v2/balances/*balanceId*/report

Retrieve a summarized report for all movements on a specific balance within a given timeframe.

Get primary balance report

GET/v2/balances/primary/report

Retrieve a summarized report for all movements on the primary balance within a given timeframe.

List balance transactions

GET/v2/balances/*balanceId*/transactions

Retrieve a list of all the movements on a specific balance.

List primary balance transactions

GET/v2/balances/primary/transactions

Retrieve a list of all the movements on the primary balance.