Fetch account balance

Use the Finance API to fetch the account balance of the merchant's preliminary or liquid account.

Prerequisites

Make sure that authorisation is set up with the following OAuth scope using OAuth API:
- READ:FINANCE

Fetch the account balance

Fetch the balance in one or both of the merchant's preliminary and liquid accounts as follows:

To check the balance of transactions that are still being checked by Zettle whether they should be paid out, fetch the preliminary account balance:
```
GET /v2/accounts/preliminary/balance
```
To check the balance of transactions that are ready to be paid out to the merchant, fetch the liquid account balance:
```
GET /v2/accounts/liquid/balance
```

Example: The following example fetches account balance in the merchant's preliminary account. The response shows that £1 is still being cleared by the acquiring bank.

Request

GET /v2/accounts/preliminary/balance

Response

1
{
2
    "data": {
3
        "totalBalance": 100,
4
        "currencyId": "GBP"
5
    }
6
}

Fetch account balance

Prerequisites

Fetch the account balance

Related information