### 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](/content/contact/index.html)  
  - 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

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

### Example Response

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