List
List card transactions
get/v1/transactions
List card transactions. All amounts are in the smallest unit of their respective currency (e.g., cents for USD) and inclusive of any acquirer fees.
Query Parameters
account_tokenstring
optional
Filters for transactions associated with a specific account.
formatuuid
beginstring
optional
Date string in RFC 3339 format. Only entries created after the specified time will be included. UTC time zone.
formatdate-time
card_tokenstring
optional
Filters for transactions associated with a specific card.
formatuuid
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.
page_sizenumber
optional
Page size (for pagination).
maximum100
minimum1
resultenum
optional
Accepts one of the following: "APPROVED", "DECLINED"
Filters for transactions using transaction result field. Can filter by APPROVED, and 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: "PENDING", "VOIDED", "SETTLED", 2 more
Filters for transactions using transaction status field.
Returns
dataarray of tokenstringaccount_tokenstringacquirer_feenumberacquirer_reference_numberstringamountnumberamountsobjectauthorization_amountnumberauthorization_codestringavsobjectcard_tokenstringcardholder_authenticationobjectcreatedstringmerchantobjectmerchant_amountnumbermerchant_authorization_amountnumbermerchant_currencystringnetworkenumnetwork_risk_scorenumberposobjectresultenumsettled_amountnumberstatusenumtoken_infoobjectupdatedstringeventsarray of objectTransaction
optional
has_moreboolean
optional
Indicates whether there are more transactions to be retrieved.
Request example Request
curl https://api.lithic.com/v1/transactions \
-H "Authorization: $LITHIC_API_KEY"200 Example
{
"data": [
{
"token": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
"account_token": "bd5e5649-1be8-4117-9bc5-3268258d1417",
"acquirer_fee": 0,
"acquirer_reference_number": "12345678987654321234567",
"amount": 1000,
"amounts": {
"cardholder": {
"amount": -1000,
"conversion_rate": "1.000000",
"currency": "USD"
},
"hold": {
"amount": 0,
"currency": "USD"
},
"merchant": {
"amount": -1000,
"currency": "USD"
},
"settlement": {
"amount": -1000,
"currency": "USD"
}
},
"authorization_amount": 1000,
"authorization_code": "123456",
"avs": {
"address": "address",
"zipcode": "zipcode"
},
"card_token": "19c22c47-7a75-43ee-9891-595419830f7e",
"cardholder_authentication": {
"3ds_version": "2",
"acquirer_exemption": "NONE",
"authentication_result": "SUCCESS",
"decision_made_by": "LITHIC_RULES",
"liability_shift": "3DS_AUTHENTICATED",
"three_ds_authentication_token": "a6e372d0-b40a-43eb-b0d1-4e1aebef5875",
"verification_attempted": "NONE",
"verification_result": "FRICTIONLESS",
"authentication_method": "FRICTIONLESS"
},
"created": "2023-09-26T21:14:28.637Z",
"merchant": {
"acceptor_id": "333301802529120",
"acquiring_institution_id": "191231",
"city": "NEW YORK",
"country": "USA",
"descriptor": "COFFEE SHOP",
"mcc": "5812",
"state": "NY"
},
"merchant_amount": 1000,
"merchant_authorization_amount": 1000,
"merchant_currency": "USD",
"network": "MASTERCARD",
"network_risk_score": 0,
"pos": {
"entry_mode": {
"card": "NOT_PRESENT",
"cardholder": "DEFERRED_BILLING",
"pan": "AUTO_ENTRY",
"pin_entered": true
},
"terminal": {
"attended": true,
"card_retention_capable": true,
"on_premise": true,
"operator": "ADMINISTRATIVE",
"partial_approval_capable": true,
"pin_capability": "CAPABLE",
"type": "ADMINISTRATIVE",
"acceptor_terminal_id": "acceptor_terminal_id"
}
},
"result": "APPROVED",
"settled_amount": 1000,
"status": "SETTLED",
"token_info": {
"wallet_type": "APPLE_PAY"
},
"updated": "2023-09-26T21:14:28.637Z",
"events": [
{
"token": "0c2adae9-f535-4505-8c35-421dad9bd0b6",
"amount": 1000,
"amounts": {
"cardholder": {
"amount": 1000,
"conversion_rate": "1.000000",
"currency": "USD"
},
"merchant": {
"amount": 1000,
"currency": "USD"
},
"settlement": {
"amount": 1000,
"conversion_rate": "1.000000",
"currency": "USD"
}
},
"created": "2023-09-26T21:14:28.637Z",
"detailed_results": [
"APPROVED"
],
"effective_polarity": "DEBIT",
"network_info": {
"acquirer": {
"acquirer_reference_number": "acquirer_reference_number",
"retrieval_reference_number": "retrieval_reference_number"
},
"amex": {
"original_transaction_id": "original_transaction_id",
"transaction_id": "transaction_id"
},
"mastercard": {
"banknet_reference_number": "banknet_reference_number",
"original_banknet_reference_number": "original_banknet_reference_number",
"original_switch_serial_number": "original_switch_serial_number",
"switch_serial_number": "switch_serial_number"
},
"visa": {
"original_transaction_id": "original_transaction_id",
"transaction_id": "transaction_id"
}
},
"result": "APPROVED",
"rule_results": [
{
"auth_rule_token": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
"explanation": "explanation",
"name": "name",
"result": "APPROVED"
}
],
"type": "CLEARING",
"network_specific_data": {
"mastercard": {
"ecommerce_security_level_indicator": "xxx",
"on_behalf_service_result": [
{
"result_1": "x",
"result_2": "x",
"service": "xx"
}
],
"transaction_type_identifier": "xxx"
},
"visa": {
"business_application_identifier": "xx"
}
}
}
]
}
],
"has_more": true
}