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

# Get account balance

`GET /v1/accounts/{id}/balance`

Returns the balance of a balance account: funds available to pay out and funds committed to in-flight payouts. Only available for accounts with holdsBalance=true.

## Path parameters

- `id` string, required

## Headers

- `X-API-Key` string

## Response `200`

Account balance

- AccountBalanceResponseDto
  - `accountId` string, required — Account ID
  - `currency` string, required — Balance currency
  - `available` MoneyOutputDto, required
    - `currency` string, required — Currency code
    - `exponent` number, required — Number of decimal places for this currency (e.g., 2 for USD, 6 for USDC)
    - `value` string, required — Amount in smallest unit as a string
    - `displayValue` string, required — Human-readable decimal value
  - `pending` MoneyOutputDto
    - `currency` string, required — Currency code
    - `exponent` number, required — Number of decimal places for this currency (e.g., 2 for USD, 6 for USDC)
    - `value` string, required — Amount in smallest unit as a string
    - `displayValue` string, required — Human-readable decimal value
  - `providerAvailableMinor` string — Live custody-partner balance in minor units. Present only when a single-account read succeeds. Does not replace available.
  - `ledgerAvailableMinor` string — Ledger available balance in minor units, echoed beside the partner read. Same amount as available.
  - `providerDriftMinor` string — Partner balance minus ledger available, in minor units. Positive means the partner holds more than the ledger.
  - `providerBalanceFetchedAt` string — When the partner balance was read

## Other responses

- `401` — Unauthorized - Invalid or missing authentication credentials

## Changes

- **2026-09-26** `0b0a3231b482` — 4 info
  - added the optional property `ledgerAvailableMinor` to the response with the `200` status
  - added the optional property `providerAvailableMinor` to the response with the `200` status
  - added the optional property `providerBalanceFetchedAt` to the response with the `200` status
  - added the optional property `providerDriftMinor` to the response with the `200` status

[Change history](https://skmtc.dev/infinite/apis/infinite-api/changes/v1/accounts/:id/balance/get.md)

---

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