Get balance
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
OAuth access with balances.read
Request
- Base URLhttps://api.mollie.com/v2
- URLhttps://api.mollie.com/v2/balances/{balanceId}
- Auth
- HTTP bearer
- or OAuth 2Authorization code: https://my.mollie.com/oauth2/authorizeToken URL: https://api.mollie.com/oauth2/tokens scopes: balances.read
Query parameters
You can enable test mode by setting the testmode query parameter to true.
Test entities cannot be retrieved when the endpoint is set to live mode, and vice versa.
Response
The balance object.
Example response
{
"resource": "balance",
"id": "bal_gVMhHKqSSRYJyPsuoPNFH",
"mode": "live",
"createdAt": "2024-03-20T09:13:37+00:00",
"currency": "EUR",
"description": "Balance description",
"status": "active",
"transferFrequency": "daily",
"transferThreshold": {
"currency": "EUR",
"value": "10.00"
},
"transferReference": "RF12-3456-7890-1234",
"transferDestination": {
"type": "bank-account",
"beneficiaryName": "John Doe"
},
"availableAmount": {
"currency": "EUR",
"value": "10.00"
},
"pendingAmount": {
"currency": "EUR",
"value": "10.00"
},
"_links": {
"self": {
"href": "https://...",
"type": "application/hal+json"
},
"documentation": {
"href": "https://...",
"type": "application/hal+json"
}
}
}Changes
No recorded changes to this operation across all 1 revision of this API.