v45

latestOpenAPI 3.0.0raw.githubusercontent.com2026-07-2684278289.5 KB

Cards

List cards

Retrieve a paginated list of cards.

get/cards

Query parameters

accountIdstring[]

Filter cards by one or more account IDs.

statusstring[]

Filter cards by one or more statuses.

typestring[]

Filter cards by type (virtual or physical).

kindstring[]

Filter cards by kind (debit or credit).

userIdstring

Filter cards by the cardholder's user ID.

limitinteger

Maximum number of results to return. Allowed range: 1 to 1000. Defaults to 500

order'asc' | 'desc'

Sort order. Can be 'asc' or 'desc'. Defaults to 'asc'

start_afterstring uuid

The ID of the card to start the page after (exclusive). When provided, results will begin with the card immediately following this ID. Use this for standard forward pagination to get the next page of results. Cannot be combined with end_before.

end_beforestring uuid

The ID of the card to end the page before (exclusive). When provided, results will end just before this ID and work backwards. Use this for reverse pagination or to retrieve previous pages. Cannot be combined with start_after.

Response

Example response

{
  "cards": [
    {
      "createdAt": "2016-07-22T00:00:00Z",
      "expiration": {
        "month": 8,
        "year": 2026
      },
      "updatedAt": "2016-07-22T00:00:00Z"
    }
  ]
}