## financial_account_token

**Type:** uuid

## business_account_token

**Type:** uuid

## account_token

**Type:** uuid

## result

**Type:** string  
**Enum:**  
- APPROVED  
- DECLINED

**Allowed:**  
- `APPROVED`  
- `DECLINED`

## status

**Type:** string  
**Enum:**  
- DECLINED  
- PENDING  
- RETURNED  
- SETTLED

**Allowed:** 
- `DECLINED`
- `PENDING`  
- `RETURNED`  
- `SETTLED`

## category

**Type:** string  
**Enum:**  
- ACH

**Allowed:**  
- `ACH`

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

## page_size

**Type:** integer  
**Description:** 1 to 100  
**Defaults to:** 50  
Page size (for pagination).

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

## `200 OK`

**Type:** object

### data
  
**Type:** array of objects

**Required**

### data*

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

#### status

**Type:** string  
**Enum:**  
**Required**  
- `PENDING`  
- `SETTLED`  
- `DECLINED`  
- `REVERSED`  
- `CANCELED`  
- `RETURNED`

#### token

**Type:** uuid  
**Required**  
Unique identifier for the transaction

#### created

**Type:** date-time  
**Required**  
ISO 8601 timestamp of when the transaction was created

#### updated

**Type:** date-time  
**Required**  
ISO 8601 timestamp of when the transaction was last updated

#### family

**Type:** const  
**Enum:**  
**Required**  
- PAYMENT

**Allowed:**  
- `PAYMENT`

#### category

**Type:** string  
**Enum:**  
**Required**  
- ACH  
- WIRE  
- BALANCE_OR_FUNDING  
- FEE  
- REWARD  
- ADJUSTMENT  
- DERECOGNITION  
- DISPUTE  
- CARD  
- EXTERNAL_ACH  
- EXTERNAL_CHECK  
- EXTERNAL_FEDNOW  
- EXTERNAL_RTP  
- EXTERNAL_TRANSFER  
- EXTERNAL_WIRE  
- MANAGEMENT_ADJUSTMENT  
- MANAGEMENT_DISPUTE  
- MANAGEMENT_FEE  
- MANAGEMENT_REWARD  
- MANAGEMENT_DISBURSEMENT  
- HOLD  
- PROGRAM_FUNDING

#### currency

**Type:** string  
Currency of the transaction in ISO 4217 format

#### result

**Type:** string  
**Enum:**  
**Required**  
- `APPROVED`  
- `DECLINED`

#### method_attributes

**Type:** object  
**Required**  
Method-specific attributes

### AchMethodAttributes  
### WireMethodAttributes

#### AchMethodAttributes object

##### financial_account_token

**Type:** uuid  
**Required**  
Financial account token

##### external_bank_account_token

**Type:** uuid | null  
**Description:** External bank account token

##### direction

**Type:** string  
**Enum:**  
**Required**  
- CREDIT  
- DEBIT

##### source

**Type:** string  
**Enum:**  
**Required**  
- LITHIC  
- EXTERNAL  
- CUSTOMER

##### method

**Type:** string  
**Enum:**  
**Required**  
- ACH_NEXT_DAY  
- ACH_SAME_DAY  
- WIRE

##### settled_amount

**Type:** integer  
**Required**  
Settled amount in cents

##### pending_amount

**Type:** integer  
**Required**  
Pending amount in cents

##### events

**Type:** array of objects  
**Required**  
List of transaction events

### events*

**Type:** object  
**Description:** Note: Inbound wire transfers are coming soon (availability varies by partner bank). Wire-related fields below are a preview. To learn more, contact your customer success manager.

#### Payment Event

##### amount

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

##### created

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

##### detailed_results

**Type:** array of strings  
More detailed reasons for the event

**Allowed:**  
- `APPROVED`  
- `DECLINED`  
- `FUNDS_INSUFFICIENT`  
- `ACCOUNT_INVALID`  
- `PROGRAM_TRANSACTION_LIMIT_EXCEEDED`  
- `PROGRAM_DAILY_LIMIT_EXCEEDED`  
- `PROGRAM_MONTHLY_LIMIT_EXCEEDED`

##### result

**Type:** string  
**Enum:**  
**Required**  
- `APPROVED`  
- `DECLINED`

##### token

**Type:** uuid  
**Required**  
Globally unique identifier

##### type

**Type:** string  
**Enum:**  
**Required**  
**Note:** Inbound wire transfers are coming soon (availability varies by partner bank). Wire-related event types below are a preview. To learn more, contact your customer success manager.

**Event types:**

**ACH events:**

- `ACH_ORIGINATION_INITIATED`  
- `ACH_ORIGINATION_REVIEWED`  
- `ACH_ORIGINATION_CANCELLED`  
- `ACH_ORIGINATION_PROCESSED`  
- `ACH_ORIGINATION_SETTLED`  
- `ACH_ORIGINATION_RELEASED`  
- `ACH_ORIGINATION_REJECTED`  
- `ACH_RECEIPT_PROCESSED`  
- `ACH_RECEIPT_SETTLED`  
- `ACH_RECEIPT_RELEASED`  
- `ACH_RECEIPT_RELEASED_EARLY`  
- `ACH_RETURN_INITIATED`  
- `ACH_RETURN_PROCESSED`  
- `ACH_RETURN_SETTLED`  
- `ACH_RETURN_REJECTED`

**Wire transfer events:**

- `WIRE_TRANSFER_INBOUND_RECEIVED`  
- `WIRE_TRANSFER_INBOUND_SETTLED`  
- `WIRE_TRANSFER_INBOUND_BLOCKED`

**Wire return events:**

- `WIRE_RETURN_OUTBOUND_INITIATED`  
- `WIRE_RETURN_OUTBOUND_SENT`  
- `WIRE_RETURN_OUTBOUND_SETTLED`  
- `WIRE_RETURN_OUTBOUND_REJECTED`

##### external_id

**Type:** string | null  
Payment event external ID. For ACH transactions, this is the ACH trace number.  
For inbound wire transfers, this is the IMAD (Input Message Accountability Data).

##### descriptor

**Type:** string  
**Required**  
Transaction descriptor

##### user_defined_id

**Type:** string | null  
User-defined identifier

##### expected_release_date

**Type:** date | null  
Expected release date for the transaction

##### related_account_tokens

**Type:** object  
**Required**  
Related account tokens for the transaction

##### Related Account Tokens

**Type:** Related Account Tokens object

###### type

**Type:** string  
**Enum:**  
- `ORIGINATION_CREDIT`  
- `ORIGINATION_DEBIT`  
- `RECEIPT_CREDIT`  
- `RECEIPT_DEBIT`  
- `WIRE_INBOUND_PAYMENT`  
- `WIRE_INBOUND_ADMIN`  
- `WIRE_OUTBOUND_PAYMENT`  
- `WIRE_OUTBOUND_ADMIN`  
- `WIRE_INBOUND_DRAWDOWN_REQUEST`

###### tags

**Type:** object  
Key-value pairs for tagging resources. Tags allow you to associate arbitrary metadata with a resource for your own purposes.

### Tags object

##### has_more

**Type:** boolean  
**Required**  
More data exists.

# Error Codes

## `400`
**Description:** A parameter in the query given in the request does not match the valid queries for the endpoint.

## `401`
**Description:** User has not been authenticated
- Invalid or missing API key
- API key is not active
- Could not find API key
- Please provide API key in Authorization header
- Please provide API key in the form Authorization: [api-key]
- Insufficient privileges. Issuing API key required
- Insufficient privileges to create virtual cards.

## `429`
**Description:** Client has exceeded the number of allowed requests in a given time period.
- Rate limited, too many requests per second
- Rate limited, reached daily limit
- Rate limited, too many keys tried

## Example Request

```shell  
curl --request GET  
     --url 'https://sandbox.lithic.com/v1/payments?page_size=50'  
     --header 'accept: application/json'  
```

## Example Response

```json  
{
  "data": [
    {
      "status": "PENDING",
      "token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "created": "2026-07-18T00:25:39.217Z",
      "updated": "2026-07-18T00:25:39.217Z",
      "family": "string",
      "category": "ACH",
      "currency": "USD",
      "result": "APPROVED",
      "method_attributes": {
        "sec_code": "CCD",
        "return_reason_code": "string",
        "ach_hold_period": 0,
        "retries": 0,
        "company_id": "string",
        "receipt_routing_number": "string",
        "trace_numbers": [
          "string"
        ],
        "addenda": "string",
        "override_company_name": "string"
      },
      "financial_account_token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "external_bank_account_token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "direction": "CREDIT",
      "source": "LITHIC",
      "method": "ACH_NEXT_DAY",
      "settled_amount": 500,
      "pending_amount": 200,
      "events": [
        {
          "amount": 0,
          "created": "2026-07-18T00:25:39.217Z",
          "detailed_results": [
            "APPROVED"
          ],
          "result": "APPROVED",
          "token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "type": "ACH_ORIGINATION_CANCELLED",
          "external_id": "string"
        }
      ],
      "descriptor": "string",
      "user_defined_id": "string",
      "expected_release_date": "2026-07-18",
      "related_account_tokens": {
        "business_account_token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "account_token": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
      },
      "type": "ORIGINATION_CREDIT",
      "tags": {
        "risk-level": "high"
      }
    }
  ],

"has_more": true
}
```