# 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
```bash
curl --request GET \
     --url https://sandbox.lithic.com/v1/cards/card_token/balances \
     --header 'accept: application/json'
```

### Example Response
```json
{
  "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
}
```