List Cards
Server-Side API
List Cards
Retrieve enrolled cards for a customer
GET
List Cards
Cards are scoped by
merchant_id (derived from your secret key) and the customer_id query
parameter. Only non-sensitive card metadata is returned — full PANs (the real card numbers) are
never exposed.Notes
- Use
status=allto include previously deleted cards for historical reference. - The
card_idreturned here is the same as theenrollmentIdfrom the SDK’scollectPAN().
Error responses
Authorizations
Your secret key: sk_test_* (sandbox) or sk_live_* (production).
Query Parameters
The customer ID to retrieve cards for (the user_id used when creating the session)
Filter by card status
Available options:
active, all Include card art URL in response
Available options:
true, false