API Documentation

card_token

Parameters

• uuid: required

• 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

200 OK

• object
  • data: array of objects
    • data*: object
      • 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.
• 404: The specified resource was not found.
• 422: Unprocessable entity.
• 429: Client has exceeded the number of allowed requests in a given time period.

Example CURL Request

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

Example Response

{
  "data": [
    {
      "available_amount": 0,
      "created": "2026-07-18T00:25:15.671Z",
      "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:15.671Z"
    }
  ],
  "has_more": true
}