---
title: "GET /api/v2/accounts/{id}/balances/"
method: GET
path: "/api/v2/accounts/{id}/balances/"
tags: ["accounts"]
---

# GET /api/v2/accounts/{id}/balances/

`GET /api/v2/accounts/{id}/balances/`

## Request

- Base URL: `https://bankaccountdata.gocardless.com`
- URL: `https://bankaccountdata.gocardless.com/api/v2/accounts/{id}/balances/`
- Auth: HTTP bearer

Access account balances.

Balances will be returned in Berlin Group PSD2 format.

## Path parameters

- `id` string, required

## Response `200`

Sample account balances

- AccountBalance: AccountBalanceSerializer.
  - `balances` BalanceSchema[]
    - `balanceAmount` BalanceAmountSchema, required: BalanceAmountSchema.
      - `amount` string, required: amount
      - `currency` string, required: currency
    - `balanceType` string, required: balanceType
    - `creditLimitIncluded` boolean: creditLimitIncluded
    - `lastChangeDateTime` string: lastChangeDateTime
    - `referenceDate` string: referenceDate
    - `lastCommittedTransaction` string: lastCommittedTransaction

## Other responses

- `400`: Invalid Account ID
- `401`: AccountInactiveError
- `403`: AccountResourceUnavailable
- `404`: Account not found
- `409`: Account state does not support this operation
- `429`: RateLimitError
- `500`: Couldn't update account balances
- `503`: ConnectionError

---

[API](https://skmtc.dev/gocardless/apis/gocardless-bank-account-data-api.md) - [All operations](https://skmtc.dev/gocardless/apis/gocardless-bank-account-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gocardless/apis/gocardless-bank-account-data-api/revisions/01fd14b88051?raw)
