List
List cards
get/v1/cards
List cards.
Query Parameters
account_tokenstring
optional
Returns cards associated with the specified 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
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.
memostring
optional
Returns cards containing the specified partial or full memo text.
page_sizenumber
optional
Page size (for pagination).
maximum100
minimum1
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.
stateenum
optional
Accepts one of the following: "CLOSED", "OPEN", "PAUSED", 2 more
Returns cards with the specified state.
Returns
dataarray of tokenstringaccount_tokenstringcard_program_tokenstringcreatedstringfundingobjectlast_fourstringpin_statusenumspend_limitnumberspend_limit_durationSpendLimitDurationstateenumtypeenumauth_rule_tokensarray of stringcardholder_currencystringdigital_card_art_tokenstringexp_monthstringexp_yearstringhostnamestringmemostringpending_commandsarray of stringproduct_idstringreplacement_forstringNonPCICard
has_moreboolean
More data exists.
Request example Request
curl https://api.lithic.com/v1/cards \
-H "Authorization: $LITHIC_API_KEY"200 Example
{
"data": [
{
"token": "7ef7d65c-9023-4da3-b113-3b8583fd7951",
"account_token": "f3f4918c-dee9-464d-a819-4aa42901d624",
"card_program_token": "5e9483eb-8103-4e16-9794-2106111b2eca",
"created": "2021-06-28T22:53:15Z",
"funding": {
"token": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
"created": "2019-12-27T18:11:19.117Z",
"last_four": "xxxx",
"state": "DELETED",
"type": "DEPOSITORY_CHECKING",
"account_name": "account_name",
"nickname": "x"
},
"last_four": "xxxx",
"pin_status": "OK",
"spend_limit": 1000,
"spend_limit_duration": "ANNUALLY",
"state": "CLOSED",
"type": "MERCHANT_LOCKED",
"auth_rule_tokens": [
"string"
],
"cardholder_currency": "USD",
"digital_card_art_token": "00000000-0000-0000-1000-000000000000",
"exp_month": "06",
"exp_year": "2027",
"hostname": "hostname",
"memo": "New Card",
"pending_commands": [
"string"
],
"product_id": "1",
"replacement_for": "5e9483eb-8103-4e16-9794-2106111b2eca"
}
],
"has_more": true
}