---
title: "Get account balance"
method: GET
path: "/rest/accounts/{account-id}/balance"
tags: ["Accounts"]
---

# Get account balance

`GET /rest/accounts/{account-id}/balance`

## Request

- Base URL: `https://api.nrich.qwist.cloud`
- URL: `https://api.nrich.qwist.cloud/rest/accounts/{account-id}/balance`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/qwist/apis/finx-api/docs/rest/accounts/:account-id/balance/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve the balance of an account identified by its ID.

## Parameters

- `#/paths/~1rest~1accounts~1{account-id}/get/parameters/0` (unresolved $ref)
- `#/paths/~1rest~1payments/get/parameters/5` (unresolved $ref)

## Response `200`

OK

- object
  - `balance` number, float, required: Account balance. This response parameter will be omitted if the balance is not yet known.
  - `balance_date` EndedAt, required (unresolved $ref)
  - `status` Status, required (unresolved $ref)

## Other responses

- `400` (unresolved $ref)
- `401` (unresolved $ref)
- `404` (unresolved $ref)
- `4XX` (unresolved $ref)

## Changes

- **2026-11-03** `398592d93b1f`: 1 breaking
  - added the new path request parameter `account-id`

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

---

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