# financial_account_token

### uuid

**Required**  
Globally unique identifier for the financial account.

### status

**string**  
**enum**  
Hold status to filter by.

Allowed:

`PENDING` `SETTLED` `EXPIRED` `VOIDED`

### begin

**date-time**  
Date string in RFC 3339 format. Only entries created after the specified time will be included. UTC time zone.

### ending_before

**string**  
A cursor representing an item's token before which a page of results should end. Used to retrieve the previous page of results before this item.

### end

**date-time**  
Date string in RFC 3339 format. Only entries created before the specified time will be included. UTC time zone.

### page_size

**integer**  
1 to 100

Defaults to 50  
Page size (for pagination).

### starting_after

**string**  
A cursor representing an item's token after which a page of results should begin. Used to retrieve the next page of results after this item.

# 200 OK

**object**  
Paginated response containing hold transactions

### data

**array of objects**  
**required**

#### data*

**object**  
Base class for all transaction types in the ledger service

### status

**string**  
**enum**  
**required**  
Status of a hold transaction

`PENDING` `SETTLED` `EXPIRED` `VOIDED`

### token

**uuid**  
**required**  
Unique identifier for the transaction

### created

**date-time**  
**required**  
ISO 8601 timestamp of when the transaction was created

### updated

**date-time**  
**required**  
ISO 8601 timestamp of when the transaction was last updated

### family

**const**  
**enum**  
**required**  
HOLD - Hold Transaction

`HOLD`

### result

**string**  
**enum**  
**required**  
`APPROVED` `DECLINED`

### financial_account_token

**uuid**  
**required**

### pending_amount

**integer**  
**required**  
Current pending amount (0 when resolved)

### currency

**string**  
**required**

### events

**array of objects**  
**required**

#### events*

**object**  
Event representing a lifecycle change to a hold

### token

**uuid**  
**required**

### type

**string**  
**enum**  
**required**  
Type of hold lifecycle event

`HOLD_INITIATED` `HOLD_VOIDED` `HOLD_EXPIRED` `HOLD_SETTLED`

### result

**string**  
**enum**  
**required**  
`APPROVED` `DECLINED`

### detailed_results

**array of objects**  
**required**

#### detailed_results*

**object**

### amount

**integer**  
**required**  
Amount in cents

### created

**date-time**  
**required**

### memo

**string | null**  
**required**

### settling_transaction_token

**uuid | null**  
**required**  
Transaction token of the payment that settled this hold (only populated for HOLD_SETTLED events)

### user_defined_id

**string | null**  
**required**

### expiration_datetime

**date-time | null**  
**required**  
When the hold will auto-expire if not resolved

### has_more

**boolean**  
**required**

# 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.

# 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 |

```bash
curl --request GET \
     --url 'https://sandbox.lithic.com/v1/financial_accounts/financial_account_token/holds?page_size=50' \
     --header 'accept: application/json'
```

```json
{
  "data": [
    {
      "status": "PENDING",
      "token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "created": "2026-07-18T00:25:35.898Z",
      "updated": "2026-07-18T00:25:35.898Z",
      "family": "string",
      "result": "APPROVED",
      "financial_account_token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "pending_amount": 0,
      "currency": "string",
      "events": [
        {
          "token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "type": "HOLD_INITIATED",
          "result": "APPROVED",
          "detailed_results": [
            "APPROVED"
          ],
          "amount": 0,
          "created": "2026-07-18T00:25:35.898Z",
          "memo": "string",
          "settling_transaction_token": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
        }
      ],
      "user_defined_id": "string",
      "expiration_datetime": "2026-07-18T00:25:35.898Z"
    }
  ],
  "has_more": true
}
```