List cards

Lists your business's cards, sorted by card name. Partner and virtual (VCC) cards aren't included; use List partner cards for those.

Narrow the list with:

  • search: matches the card name or last 4 digits.
  • card_holder_identifiers: only cards owned by these users.
  • statuses: active, inactive, frozen, or cancelled.
  • types: virtual or physical.

Each card includes its status, card holder, spend this month, and any spend limits it has reached. Results are paginated: 100 cards per page by default. See Pagination.

Query Params
integer
Defaults to 1

Page number for pagination

integer
1 to 1000

Number of items per page. A value above 1000 returns 422.

Free-text search across card fields.

card_holder_identifiers
array of strings

Filter by one or more card holder identifiers.

card_holder_identifiers
statuses
array of strings

Filter by one or more dashboard card statuses.

statuses
types
array of strings

Filter by one or more card types.

types
Allowed:
Responses

429

Too many requests. You sent more than 100 requests in 30 seconds from one IP address. This response has no JSON body. See Rate limits.

500

Unexpected error

Language
Credentials
Header
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json