Get financial transaction

Schema Definition

financial_account_token

• uuid (required): Globally unique identifier for financial account.

financial_transaction_token

• uuid (required): Globally unique identifier for financial transaction token.

Response Structure

200 OK

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

  • 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.
        • APPROVED
        • DECLINED
      • token (uuid): Globally unique identifier.
      • type (string, enum): Various types of financial events including ACH_ORIGINATION_CANCELLED, AUTHORIZATION, TRANSFER, etc.

  • pending_amount (integer, required): Pending amount of the transaction in the currency's smallest unit (e.g., cents), including any acquirer fees. The value will go to zero over time once the transaction is settled.

  • result (string, enum, required): APPROVED transactions were successful while DECLINED transactions were declined by user, Lithic, or the network.

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

  • status (string, enum, required): Status types:

    • DECLINED: The transaction was declined.
    • EXPIRED: The authorization 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.

  • token (uuid, required): Globally unique identifier.

  • updated (date-time, required): Date and time when the financial transaction was last updated. UTC time zone.

Error Responses

• 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; Could not find API key; Please provide API key in Authorization header; Insufficient privileges.
• 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/financial_accounts/financial_account_token/financial_transactions/financial_transaction_token \
     --header 'accept: application/json'

Example Response

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