# card_token

- **uuid**  
  required

- **financial_transaction_token**  
  uuid
  required
  Globally unique identifier for financial transaction token.

# Response Codes

## `200 OK`

- **object**

### Fields

- **category**  
  - **type:** string  
  - **enum**  
  - **required**  
  - **Status types:**  
    - `CARD` - Issuing card transaction.  
    - `ACH` - Transaction over ACH.  
    - `INTERNAL` - Transaction for internal adjustment.  
    - `TRANSFER` - Internal transfer of funds between financial accounts in your program.

- **created**  
  - **type:** date-time  
  - **required**  
  - Date and time when the financial transaction first occurred. UTC time zone.

- **currency**  
  - **type:** string  
  - **required**  
  - 3-character alphabetic ISO 4217 code for the settling currency of the transaction.

- **descriptor**  
  - **type:** string  
  - **required**  
  - A string that provides a description of the financial transaction; may be useful to display to users.

- **events**  
  - **type:** array of objects  
  - **required**  
  - A list of all financial events that have modified this financial transaction.

### Event Object

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

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

- **result**  
  - **type:** string  
  - **enum**  
      - `APPROVED` - Financial events were successful.
      - `DECLINED` - Financial events were declined by user, Lithic, or the network.

- **token**  
  - **type:** uuid  
  - Globally unique identifier.

- **type**  
  - **type:** string  
  - **enum**  
    - Various types of transaction events.

- **pending_amount**  
  - **type:** integer  
  - **required**  
  - Pending amount of the transaction in the currency's smallest unit (e.g., cents), including any acquirer fees.

- **result**  
  - **type:** string  
  - **required**  
  - `APPROVED` or `DECLINED` transaction status.

- **settled_amount**  
  - **type:** integer  
  - **required**  
  - Amount of the transaction that has been settled in the currency's smallest unit (e.g., cents), including any acquirer fees.

- **status**  
  - **type:** string  
  - **required**  
  - **Status types:**  
    - `DECLINED`  
    - `EXPIRED`  
    - `PENDING`  
    - `RETURNED`  
    - `SETTLED`  
    - `VOIDED`

- **token**  
  - **type:** uuid  
  - **required**  
  - Globally unique identifier.

- **updated**  
  - **type:** date-time  
  - **required**  
  - Date and time when the financial transaction was last updated. UTC time zone.

# Error Codes

- **400** - A parameter in the query given in the request does not match the valid queries for the endpoint.
- **401** - Various authentication related errors.
- **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 Request

```bash
curl --request GET \
     --url https://sandbox.lithic.com/v1/cards/card_token/financial_transactions/financial_transaction_token \
     --header 'accept: application/json'
```

# Example Response

```json
{
  "category": "ACH",
  "created": "2026-07-18T00:25:16.178Z",
  "currency": "string",
  "descriptor": "string",
  "events": [
    {
      "amount": 0,
      "created": "2026-07-18T00:25:16.178Z",
      "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:16.178Z"
}
```