List balances

API Reference for Listing Balances

Account Balance Query

Request Parameters

Parameter	Type	Description
account_token	uuid	List balances for all financial accounts of a given account_token.
business_account_token	uuid	List balances for all financial accounts of a given business_account_token.
balance_date	date-time	UTC date and time of the balances to retrieve. Defaults to latest available balances.
financial_account_type	string enum	List balances for a given Financial Account type. Possible values: `ISSUING`, `OPERATING`, `RESERVE`, `SECURITY`.

Response

HTTP Status Codes

Code	Description
200	OK
400	A parameter in the query given in the request does not match the valid queries for the endpoint.
401	User has not been authenticated or invalid/missing API key.
404	The specified resource was not found.
422	Unprocessable entity.
429	Client has exceeded the number of allowed requests in a given time period.

Response Body

{
  "data": [
    {
      "available_amount": 0,
      "created": "2026-07-18T00:25:13.550Z",
      "currency": "string",
      "financial_account_token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "financial_account_type": "CARD",
      "last_transaction_event_token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "last_transaction_token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "pending_amount": 0,
      "total_amount": 0,
      "updated": "2026-07-18T00:25:13.550Z"
    }
  ],
  "has_more": true
}

cURL Example

curl --request GET \
     --url https://sandbox.lithic.com/v1/balances \
     --header 'accept: application/json'