Skip to content

List

List card financial transactions
get/v1/cards/{card_token}/financial_transactions

List the financial transactions for a given card.

Path Parameters
card_tokenstring
formatuuid
Query Parameters
beginstring
optional

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

formatdate-time
categoryenum
optional
Accepts one of the following: "CARD", "TRANSFER"

Financial Transaction category to be returned.

Hide ParametersShow Parameters
"CARD"
"TRANSFER"
endstring
optional

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

formatdate-time
ending_beforestring
optional

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.

resultenum
optional
Accepts one of the following: "APPROVED", "DECLINED"

Financial Transaction result to be returned.

Hide ParametersShow Parameters
"APPROVED"
"DECLINED"
starting_afterstring
optional

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.

statusenum
optional
Accepts one of the following: "DECLINED", "EXPIRED", "PENDING", 3 more

Financial Transaction status to be returned.

Hide ParametersShow Parameters
"DECLINED"
"EXPIRED"
"PENDING"
"RETURNED"
"SETTLED"
"VOIDED"
Returns
dataarray of tokenstringcategoryenumcreatedstringcurrencystringdescriptorstringeventsarray of objectpending_amountnumberresultenumsettled_amountnumberstatusenumupdatedstringFinancialTransaction
has_moreboolean

More data exists.

Request example Request
curl https://api.lithic.com/v1/cards/$CARD_TOKEN/financial_transactions \
    -H "Authorization: $LITHIC_API_KEY"
200 Example
{
  "data": [
    {
      "token": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
      "category": "ACH",
      "created": "2019-12-27T18:11:19.117Z",
      "currency": "currency",
      "descriptor": "descriptor",
      "events": [
        {
          "token": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
          "amount": 0,
          "created": "2019-12-27T18:11:19.117Z",
          "result": "APPROVED",
          "type": "ACH_ORIGINATION_CANCELLED"
        }
      ],
      "pending_amount": 0,
      "result": "APPROVED",
      "settled_amount": 0,
      "status": "DECLINED",
      "updated": "2019-12-27T18:11:19.117Z"
    }
  ],
  "has_more": true
}