List payments

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

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

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

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

Example Response

{
  "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
}