card_token

uuid
required

category
string

enum
Financial Transaction category to be returned.

• CARDTRANSFER
  Allowed: CARD TRANSFER

result
string

enum
Financial Transaction result to be returned.

• APPROVEDDECLINED
  Allowed: APPROVED DECLINED

status
string

enum
Financial Transaction status to be returned.

• DECLINEDEXPIREDPENDINGRETURNEDSETTLEDVOIDED
  Allowed: DECLINED EXPIRED PENDING RETURNED SETTLED VOIDED

begin
date-time

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

end
date-time

Date string in RFC 3339 format. Only entries created before 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.

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

data

array of objects

required

data*

object

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

Allowed: ACH CARD INTERNAL TRANSFER

created
date-time

required

Date and time when the financial transaction first occurred. UTC time zone.

currency
string

required

3-character alphabetic ISO 4217 code for the settling currency of the transaction.

descriptor
string

required

A string that provides a description of the financial transaction; may be useful to display to users.

events
array of objects

required

A list of all financial events that have modified this financial transaction.

events*

object

Financial Event

amount
integer

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

created
date-time

Date and time when the financial event occurred. UTC time zone.

result
string

enum
APPROVED financial events were successful while DECLINED financial events were declined by user, Lithic, or the network.

Allowed: APPROVED DECLINED

token
uuid

Globally unique identifier.

type
string

enum

Transaction types including but not limited to:

• ACH_ORIGINATION_CANCELLED
• ACH_ORIGINATION_INITIATED
• ACH_ORIGINATION_PROCESSED
• AUTHORIZATION
• CARD_TO_CARD
• (and others)

pending_amount
integer

required

Pending amount of the transaction in the currency's smallest unit (e.g., cents), including any acquirer fees.

This value will go to zero over time once the financial transaction is settled.

result
string

required

APPROVED transactions were successful while DECLINED transactions were declined by user, Lithic, or the network.

Allowed: APPROVED DECLINED

settled_amount
integer

required

Amount of the transaction that has been settled in the currency's smallest unit (e.g., cents), including any acquirer fees. This may change over time.

status
string

required

Status types:

• DECLINED - The transaction was declined.
• EXPIRED - The authorization as it has passed its expiration time. Card transaction only.
• PENDING - The transaction is expected to settle.
• RETURNED - The transaction has been returned.
• SETTLED - The transaction is completed.
• VOIDED - The transaction was voided. Card transaction only.

Allowed: DECLINED EXPIRED PENDING RETURNED SETTLED VOIDED

token
uuid

required

Globally unique identifier.

updated
date-time

required

Date and time when the financial transaction was last updated. UTC time zone.

has_more
boolean

required

More data exists.

``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 | | Insufficient privileges to create virtual cards. | Creating virtual cards requires an additional privilege |

``404 The specified resource was not found.

``422 Unprocessable entity.

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

Example Request:

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

Example Response:

{
  "data": [
    {
      "category": "ACH",
      "created": "2026-07-18T00:25:15.911Z",
      "currency": "string",
      "descriptor": "string",
      "events": [
        {
          "amount": 0,
          "created": "2026-07-18T00:25:15.911Z",
          "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:15.911Z"
    }
  ],
  "has_more": true
}