Financial Account Token

Parameters

financial_account_token

• Type: uuid
• Required: Yes
• Description: Globally unique identifier for financial account.

category

• Type: string
• Enum: ACH, CARD, INTERNAL, TRANSFER
• Description: Financial Transaction category to be returned.

result

• Type: string
• Enum: APPROVED, DECLINED
• Description: Financial Transaction result to be returned.

status

• Type: string
• Enum: DECLINED, EXPIRED, PENDING, RETURNED, SETTLED, VOIDED
• Description: Financial Transaction status to be returned.

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.

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

200 OK

• Type: object
  • Property: data
    • Type: array of objects
    • Required: Yes

Data Structure

• category

  • Type: string
  • Enum: CARD, ACH, INTERNAL, TRANSFER

• created

  • Type: date-time
  • Required: Yes
  • Description: Date and time when the financial transaction first occurred. UTC time zone.

• currency

  • Type: string
  • Required: Yes
  • Description: 3-character alphabetic ISO 4217 code for the settling currency of the transaction.

• descriptor

  • Type: string
  • Required: Yes
  • Description: A string that provides a description of the financial transaction; may be useful to display to users.

• events

  • Type: array of objects
  • Required: Yes

Events Structure

• amount

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

• created

  • Type: date-time
  • Description: Date and time when the financial event occurred. UTC time zone.

• result

  • Type: string
  • Enum: APPROVED, DECLINED

• token

  • Type: uuid
  • Description: Globally unique identifier.

• type

  • Type: string
  • Enum: Various transaction events like ACH_ORIGINATION_CANCELLED, AUTHORIZATION, etc.

• pending_amount

  • Type: integer
  • Required: Yes
  • Description: Pending amount of the transaction in the currency's smallest unit (e.g., cents), including any acquirer fees.

• result

  • Type: string
  • Enum: APPROVED, DECLINED

• settled_amount

  • Type: integer
  • Required: Yes
  • Description: Amount of the transaction that has been settled in the currency's smallest unit (e.g., cents).

• status

  • Type: string
  • Enum: DECLINED, EXPIRED, PENDING, RETURNED, SETTLED, VOIDED
  • Required: Yes

• token

  • Type: uuid
  • Required: Yes

• updated

  • Type: date-time
  • Required: Yes

• has_more

  • Type: boolean
  • Required: Yes

Example Request

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

Example Response

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