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

# Get primary balance

`GET /balances/primary`

## Request

- Base URL: `https://api.mollie.com/v2`
- URL: `https://api.mollie.com/v2/balances/primary`
- 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 the primary balance. This is the balance of your account's primary currency, where all payments are settled to by default.

This endpoint is a convenient alias of the [Get balance](get-balance) endpoint.

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

## Response `200`

The primary 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

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