---
title: "List balances"
method: GET
path: "/balances"
tags: ["Balance"]
---

# List balances

`GET /balances`

## Request

- Base URL: `https://api.gocardless.com`
- URL: `https://api.gocardless.com/balances`
- Auth: HTTP bearer

Returns a [cursor-paginated](https://docs.gocardless.com/docs/api-reference/data-conventions#cursor-pagination) list of balances for a given creditor. This endpoint is rate limited to 60 requests per minute.

## Query parameters

- `before` string, nullable
- `after` string, nullable
- `limit` union
  - integer
  - string
- `creditor` string, required

## Headers

- `GoCardless-Version` string, required

## Response `200`

Successful response

- BalanceMultiResourceResponse
  - `balances` object[]
    - `balance_type` 'confirmed_funds' | 'pending_payouts' | 'pending_payments_submitted': Type of the balance. Could be one of - `pending_payments_submitted`: Payments we have submitted to the scheme but not yet confirmed. This does not exactly correspond to <i>Pending payments</i> in the dashboard, because this balance does not include payments that are pending submission. - `confirmed_funds`: Payments that have been confirmed minus fees and unclaimed debits for refunds, failures and chargebacks. These funds have not yet been moved into a payout. - `pending_payouts`: Confirmed payments that have been moved into a payout. This is the total due to be paid into your bank account in the next payout run (payouts happen once every business day). `pending_payouts` will only be non-zero while we are generating and submitting the payouts to our partner bank.
    - `amount` integer: The total amount in the balance, defined as the sum of all debits subtracted from the sum of all credits, in the lowest denomination for the currency (e.g. pence in GBP, cents in EUR).
    - `currency` 'AUD' | 'CAD' | 'DKK' | 'EUR' | 'GBP' | 'NZD' | 'SEK' | 'USD': [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217#Active_codes) currency code. Currently "AUD", "CAD", "DKK", "EUR", "GBP", "NZD", "SEK" and "USD" are supported.
    - `last_updated_at` string, date-time: Dynamic [timestamp](https://docs.gocardless.com/docs/api-reference/data-conventions#dates-and-times) recording when this resource was last updated.
    - `links` BalanceLinks
      - `creditor` string: ID of the associated [creditor](https://docs.gocardless.com/docs/api-reference/creditor).
  - `meta` BalancePaginationMeta: Cursor pagination information
    - `limit` integer, required
    - `cursors` object, required
      - `before` string, nullable, required: Cursor pointing to the end of the desired set.
      - `after` string, nullable, required: Cursor pointing to the start of the desired set.

## Other responses

- `400`: Bad Request
- `401`: Unauthorised
- `404`: Not found
- `422`: Validation Error
- `500`: Internal Error

---

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