# Financial Account Token

## Parameters

### `financial_account_token`
- **Type**: `uuid`  
- **Required**: Yes  
- **Description**: Globally unique identifier for financial account.

### `category`
- **Type**: `string`  
- **Enum**: `ACH`, `CARD`, `INTERNAL`, `TRANSFER`  
- **Description**: Financial Transaction category to be returned.

### `result`
- **Type**: `string`  
- **Enum**: `APPROVED`, `DECLINED`  
- **Description**: Financial Transaction result to be returned.

### `status`
- **Type**: `string`  
- **Enum**: `DECLINED`, `EXPIRED`, `PENDING`, `RETURNED`, `SETTLED`, `VOIDED`  
- **Description**: Financial Transaction status to be returned.

### `begin`
- **Type**: `date-time`  
- **Description**: Date string in RFC 3339 format. Only entries created after the specified time will be included. UTC time zone.

### `end`
- **Type**: `date-time`  
- **Description**: Date string in RFC 3339 format. Only entries created before the specified time will be included. UTC time zone.

### `ending_before`
- **Type**: `string`  
- **Description**: 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.

### `starting_after`
- **Type**: `string`  
- **Description**: 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.

## Response

### ``200 OK``
- **Type**: `object`
  - **Property**: `data`
    - **Type**: `array of objects`
    - **Required**: Yes

#### Data Structure

- **category**
  - **Type**: `string`
  - **Enum**: `CARD`, `ACH`, `INTERNAL`, `TRANSFER`

- **created**
  - **Type**: `date-time`
  - **Required**: Yes
  - **Description**: Date and time when the financial transaction first occurred. UTC time zone.

- **currency**
  - **Type**: `string`
  - **Required**: Yes
  - **Description**: 3-character alphabetic ISO 4217 code for the settling currency of the transaction.

- **descriptor**
  - **Type**: `string`
  - **Required**: Yes
  - **Description**: A string that provides a description of the financial transaction; may be useful to display to users.

- **events**
  - **Type**: `array of objects`
  - **Required**: Yes

##### Events Structure

- **amount**
  - **Type**: `integer`
  - **Description**: Amount of the financial event that has been settled in the currency's smallest unit (e.g., cents).

- **created**
  - **Type**: `date-time`
  - **Description**: Date and time when the financial event occurred. UTC time zone.

- **result**
  - **Type**: `string`
  - **Enum**: `APPROVED`, `DECLINED`

- **token**
  - **Type**: `uuid`
  - **Description**: Globally unique identifier.

- **type**
  - **Type**: `string`
  - **Enum**: Various transaction events like `ACH_ORIGINATION_CANCELLED`, `AUTHORIZATION`, etc.

- **pending_amount**
  - **Type**: `integer`
  - **Required**: Yes
  - **Description**: Pending amount of the transaction in the currency's smallest unit (e.g., cents), including any acquirer fees.

- **result**
  - **Type**: `string`
  - **Enum**: `APPROVED`, `DECLINED`

- **settled_amount**
  - **Type**: `integer`
  - **Required**: Yes
  - **Description**: Amount of the transaction that has been settled in the currency's smallest unit (e.g., cents).

- **status**
  - **Type**: `string`
  - **Enum**: `DECLINED`, `EXPIRED`, `PENDING`, `RETURNED`, `SETTLED`, `VOIDED`
  - **Required**: Yes

- **token**
  - **Type**: `uuid`
  - **Required**: Yes

- **updated**
  - **Type**: `date-time`
  - **Required**: Yes

- **has_more**
  - **Type**: `boolean`
  - **Required**: Yes

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

### Example Response
```json
{
  "data": [
    {
      "category": "ACH",
      "created": "2026-07-18T00:25:33.366Z",
      "currency": "string",
      "descriptor": "string",
      "events": [
        {
          "amount": 0,
          "created": "2026-07-18T00:25:33.366Z",
          "result": "APPROVED",
          "token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "type": "ACH_ORIGINATION_CANCELLED"
        }
      ],
      "pending_amount": 0,
      "result": "APPROVED",
      "settled_amount": 0,
      "status": "DECLINED",
      "token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "updated": "2026-07-18T00:25:33.366Z"
    }
  ],
  "has_more": true
}
```