INinfinite
Accounts

Get account balance

Changed on

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.

get/v1/accounts/{id}/balance

Request

Path parameters

idstring required

Balance account ID

Headers

X-API-Keystring

API key

Response

Account balance

accountIdstring required

Account ID

currencystring required

Balance currency

providerAvailableMinorstring

Live custody-partner balance in minor units. Present only when a single-account read succeeds. Does not replace available.

ledgerAvailableMinorstring

Ledger available balance in minor units, echoed beside the partner read. Same amount as available.

providerDriftMinorstring

Partner balance minus ledger available, in minor units. Positive means the partner holds more than the ledger.

providerBalanceFetchedAtstring

When the partner balance was read

Example response

{
  "accountId": "vba_abc123",
  "currency": "USD",
  "available": {
    "currency": "USD",
    "exponent": 2,
    "value": "12345",
    "displayValue": "123.45"
  },
  "pending": {
    "currency": "USD",
    "exponent": 2,
    "value": "12345",
    "displayValue": "123.45"
  },
  "providerAvailableMinor": "8500",
  "ledgerAvailableMinor": "8000",
  "providerDriftMinor": "500",
  "providerBalanceFetchedAt": "2026-09-24T04:00:00.000Z"
}

Changes

  • 0b0a3231b482Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status