---
title: "Retrieve the balance for a specific bank account"
method: GET
path: "/api/accounts/{bank-account-id}/balance"
tags: ["XS2A.api.accounts"]
---

# Retrieve the balance for a specific bank account

`GET /api/accounts/{bank-account-id}/balance`

## Request

- Base URL: `https://api.xs2a.com/v1`
- URL: `https://api.xs2a.com/v1/api/accounts/{bank-account-id}/balance`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/xs2a/apis/xs2a-api/docs/api/accounts/:bank-account-id/balance/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `bank-account-id` string, required

## Response `200`

Request successfully processed

- BankAccountBalance
  - `id` string: Bank Account ID
  - `available` number, float, nullable: The available amount. This can be null, if the available amount is not known.
  - `limit` number, float, nullable: The limit of the account. This can be null, if the limit is not known.
  - `balance` number, float, nullable: The current account balance.
  - `currency_id` 'EUR' | 'CHF': The id of the currency to be used.
  - `date` string: The date the balance was seen on.
  - `created_at` string: Date of creation
  - `object` string: The value bank_account

## Other responses

- `401`: Authentication failed API key missing or not valid
- `403`: Forbidden Access blocked
- `404`: Product not enabled or Not found The requested object does not exist on the server
- `422`: Validation failed Something is wrong with the user input
- `500`: An internal server problem occurred

## Changes

- **2026-09-01** `ae5fbc5feee3`: 1 breaking
  - the response property `balance` became nullable for the status `200`

[Operation history](https://skmtc.dev/xs2a/apis/xs2a-api/changes/api/accounts/:bank-account-id/balance/get.md)

---

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