Get balances

Financial Account Token

• uuid

  • required
  • Globally unique identifier for financial account.

• balance_date

  • date-time
  • UTC date of the balance to retrieve. Defaults to latest available balance

• last_transaction_event_token

  • uuid
  • Balance after a given financial event occurred.
  • For example, passing the event_token of a $5 CARD_CLEARING financial event will return a balance decreased by $5

Response Structure

200 OK

• object

  • data
    • array of objects
    • required

• data*

  • object
  • Balance of a Financial Account

• available_amount
  - integer
  - required
  - Funds available for spend in the currency's smallest unit (e.g., cents for USD)

• created
  - date-time
  - required
  - Date and time for when the balance was first created.

• currency
  - string
  - required
  - 3-character alphabetic ISO 4217 code for the local currency of the balance.

• token
  - uuid
  - required
  - Globally unique identifier for the financial account that holds this balance.

• type
  - string
  - enum
  - required
  - Type of financial account.
  - ISSUING, OPERATING, RESERVE, SECURITY

• last_transaction_event_token
  - uuid
  - required
  - Globally unique identifier for the last financial transaction event that impacted this balance.

• last_transaction_token
  - uuid
  - required
  - Globally unique identifier for the last financial transaction that impacted this balance.

• pending_amount
  - integer
  - required
  - Funds not available for spend due to card authorizations or pending ACH release. Shown in the currency's smallest unit (e.g., cents for USD).

• total_amount
  - integer
  - required
  - The sum of available and pending balance in the currency's smallest unit (e.g., cents for USD).

• updated
  - date-time
  - required
  - Date and time for when the balance was last updated.

• has_more
  - boolean
  - required
  - More data exists.

Error Codes

• 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
  • Invalid or missing API key
  • API key is not active
  • The API key used is no longer active
  • Could not find API key
  • The API key provided is not associated with any user
  • Please provide API key in Authorization header
  • The Authorization header is not in the request
  • Please provide API key in the form Authorization: [api-key]
  • The Authorization header is not formatted properly
  • Insufficient privileges. Issuing API key required
  • Write access requires an Issuing API key. Reach out at lithic.com/contact
  • Insufficient privileges to create virtual cards. Creating virtual cards requires an additional privilege

• 404

  • The specified resource was not found.

• 422

  • Unprocessable entity.

• 429

  • Client has exceeded the number of allowed requests in a given time period.
  • Rate limited, too many requests per second
  • User has exceeded their per second rate limit
  • Rate limited, reached daily limit
  • User has exceeded their daily rate limit
  • Rate limited, too many keys tried
  • One IP has queried too many different API keys.

Example Request

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

Example Response

{
  "data": [
    {
      "available_amount": 0,
      "created": "2026-07-18T00:25:13.856Z",
      "currency": "string",
      "token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "type": "ISSUING",
      "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.856Z"
    }
  ],
  "has_more": true
}