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

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

Example Response

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