GET
/v1/issuing/cardsList Issuing cards
Lists Issuing cards in descending creation order, with the newest cards first. Filter results by cardholder, creation time, expiration, last four digits, personalization design, status, or type, and use cursor parameters to paginate the collection.
- RetriesRetries up to 2×, 500ms backoff, 30s timeout.
cardholderstringoptional
Filters cards to those belonging to the specified cardholder.
createdobjectoptional
Filters cards by issuance time using a Unix timestamp or a date-interval object.
ending_beforestringoptional
Object ID cursor that identifies the end of the current position when retrieving the previous page.
exp_monthintegeroptional
Filters cards by expiration month.
exp_yearintegeroptional
Filters cards by expiration year.
expandarray<string>optional
Fields to expand in each card response. Each field name can contain up to 5,000 characters.
last4stringoptional
Filters cards by the last four digits of the card number. Maximum 5,000 characters.
limitintegeroptional
Maximum number of cards to return. Must be between 1 and 100. Defaults to 10 when omitted.
personalization_designstringoptional
Filters cards by personalization design identifier. Maximum 5,000 characters.
starting_afterstringoptional
Object ID cursor that identifies the current position when retrieving the next page.
statusstringoptional
Filters by card status: active, canceled, or inactive.
typestringoptional
Filters by card type: virtual or physical.
200Returns a list object containing card objects in descending creation order, a `has_more` flag, the list object type, and the collection URL.
dataarray<Card>required
has_morebooleanrequired
True if this list has another page of items after this one that can be fetched.
objectstringrequired
String representing the object's type. Objects of the same type share the same value. Always has the value `list`.
urlstringrequired
The URL where this list can be accessed.
defaultError response.
errorobjectrequired
Error handling
limit must be between 1 and 100 and defaults to 10 when omitted. status must be one of active, canceled, or inactive, while type must be virtual or physical. Use starting_after and ending_before as object-ID cursors when navigating pages.