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