---
title: "Get card balance"
method: GET
path: "/cards/{account_id}/balance"
tags: ["Cards"]
---

# Get card balance

`GET /cards/{account_id}/balance`

## Request

- Base URL: `https://api.truelayer-sandbox.com/data/v1`
- URL: `https://api.truelayer-sandbox.com/data/v1/cards/{account_id}/balance`
- Auth: OAuth 2
  - Authorization code: `https://auth.truelayer.com/token/connect`
  - Token URL: `https://auth.truelayer.com/token/connect` scopes: `cards`, `balance`

Get balance for specified card

## Path parameters

- `account_id` string, required

## Query parameters

- `async` 'true'
- `webhook_uri` string, uri

## Headers

- `X-Client-Correlation-Id` string
- `X-PSU-IP` string

## Response `200`

OK

- object
  - `results` CardBalance[]
    - `available` string
    - `currency` 'EUR' | 'GBP' | 'USD' | 'AUD': Currency used for this account or transaction
    - `current` number, required
    - `credit_limit` number
    - `last_statement_balance` number
    - `last_statement_date` string, datetime
    - `payment_due` number
    - `payment_due_date` string, datetime
    - `update_timestamp` string, datetime
  - `status` 'Succeeded' | 'Queued' | 'Running' | 'Failed': Indicates whether the request was successful. 'Queued', 'Running' and 'Failed' can be returned for async requests.

## Other responses

- `202`: Accepted
- `401`: Unauthorized
- `403`: Access denied
- `404`: Not found
- `429`: Rate limit exceeded
- `500`: Internal server error
- `501`: Not implemented
- `503`: Service unavailable
- `504`: Gateway timeout

---

[API](https://skmtc.dev/truelayer/apis/data-api-v1.md) - [All operations](https://skmtc.dev/truelayer/apis/data-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/truelayer/apis/data-api-v1/revisions/2906fd6d5b2a?raw)