GET/cards

List cards

Lists Cards and their account, status, and configuration details. Filter results by Account, creation time, status, or idempotency key, and use cursor to paginate through the results. Each page contains up to 100 cards and includes a next_cursor value when another page is available.

9 parameters
cursorstringoptional
Pagination cursor identifying the position after which to return entries.
limitintegeroptional
Maximum number of Cards to return. Must be at least 1 and no greater than 100. Defaults to 100 when omitted.
Default:100
account_idstringoptional
Filter results to Cards belonging to this Account.
created_at.afterstringoptional
Return results created after this ISO 8601 timestamp.
created_at.beforestringoptional
Return results created before this ISO 8601 timestamp.
created_at.on_or_afterstringoptional
Return results created at or after this ISO 8601 timestamp.
created_at.on_or_beforestringoptional
Return results created at or before this ISO 8601 timestamp.
status.inarray<string>optional
Filter by status using a comma-delimited list: `active`, `disabled`, or `canceled`.
idempotency_keystringoptional
Filter for the Card with this idempotency key. Must be 1 to 200 characters.

3 status codes
200Returns a page containing an array of Card objects and a `next_cursor` value for retrieving the next page; the cursor is null when there are no more results.
dataarray<Card>required
The contents of the list.
next_cursorstringrequired
A pointer to a place in the list. Pass this as the `cursor` parameter to retrieve the next page of results. If there are no more results, the value will be `null`.
4XXReturned when the request is invalid or cannot be processed.
5XXReturned when the server encounters an error processing the request.

Error handling

limit must be at least 1 and no greater than 100; it defaults to 100 when omitted. status.in accepts comma-delimited values from active, disabled, and canceled, and idempotency_key must be 1 to 200 characters. Supply creation-time filters as ISO 8601 timestamps.