---
title: "Retrieves a bank account balance"
method: GET
path: "/bank-accounts/{bank_account_id}/balance"
tags: ["Bank accounts"]
---

# Retrieves a bank account balance

`GET /bank-accounts/{bank_account_id}/balance`

## Request

- Base URL: `https://api.rillet.com`
- URL: `https://api.rillet.com/bank-accounts/{bank_account_id}/balance`
- Auth: HTTP bearer

Returns the latest stored bank balance on or before the requested date in the bank account's native currency.
The response includes the stored balance date so consumers can identify when the latest available balance predates the requested date.

## Path parameters

- `bank_account_id` string, uuid, required

## Query parameters

- `as_of_date` string, date, required

## Response `200`

OK

- BankAccountBalance
  - `bank_account_id` string, uuid, required
  - `as_of_date` string, date, required: The requested as-of date.
  - `balance_date` string, date, required: The date of the stored balance returned, which may precede the requested as-of date.
  - `balance` MonetaryAmount, required
    - `amount` string, required: Monetary amount in decimal format, using a period (.) as the decimal separator. (e.g. '1.01' in $ currency represents 1$ and 1 cent.)
    - `currency` string, required: Currency code following ISO-4217

## Other responses

- `default`: Error

## Changes

- **2026-11-03** `c393d0102005`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/rillet/apis/rillet-accounting-api/changes/bank-accounts/:bank_account_id/balance/get.md)

---

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