Skip to main content
GET
List Cards
The external_id field in the response can be passed as card-token when using Marqeta UX Toolkit components.

Authorizations

Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Query Parameters

account_id
string

The ID of the account that the card should be issued against. Filterable.

card_product_id
string

The ID of the card product that this card should be issued from. Filterable.

last4
string

Last 4 digits of the card number. Filterable.

person_id
string

The ID of the person representing the cardholder that this card will be issued to. Filterable.

show_cvv
enum<string>

When true, the cvv field will be returned with non-null data. False by default. Requires PCI compliance.

Available options:
true,
false
show_pan
enum<string>

When true, the pan field will be returned with non-null data. False by default. Requires PCI compliance.

Available options:
true,
false
status
string

One of: unactivated, active, suspended, terminated. Filterable.

page_cursor
string

Pagination cursor, value is the object ID.

page_size
integer
default:100

Limits the number of objects in the returned list, value must be a number greater than or equal to 1. Defaults to 100.

Required range: x >= 1
from_date
string

Lists the objects created on the date provided and onwards. Date must be in ISO 8601 format (“YYYY-MM-DD”).

to_date
string

Lists the objects created before the date provided. Date must be in ISO 8601 format (“YYYY-MM-DD”).

Response

200 - application/json

A dictionary with a data property that contains a list of up to page_size card elements, starting after the card described by page_cursor. If no more cards are available, the resulting list will be empty.

data
object[]