---
title: "List Cards"
method: GET
path: "/cards"
tags: ["Cards"]
---

# List Cards

`GET /cards`

Returns a list of cards. You can use the `limit`, `page`, `sortBy` and `sortDirection` parameters to filter and sort the results.

**This endpoint has changed in comparison to the previous version of the API.** The following changes were made:
- changed the enumeration for the status field in the response body

## Query parameters

- `organizationId` string, uuid, required
- `cardAccountId` string, uuid
- `status` string[]
- `cardholderId` string, uuid
- `type` string[]
- `cardConfig` string[]
- `fromDate` string, date-time
- `toDate` string, date-time
- `byDateField` 'createdAt' | 'updatedAt', nullable
- `limit` integer
- `page` integer
- `sortBy` 'organizationId' | 'status' | 'cardholderId' | 'updatedAt'
- `sortDirection` 'ASC' | 'DESC'

## Response `200`

Ok

- object
  - `data` object[]
    - `cardId` string, uuid — The unique identifier of the card.
    - `organizationId` string, uuid — The unique identifier of the organization.
    - `cardAccountId` string, uuid — The unique identifier of the card account.
    - `cardholderId` string, uuid — The unique identifier of the cardholder.
    - `type` 'VIRTUAL' | 'SINGLE_USE' | 'PHYSICAL' | 'BLACK' | 'TRAVEL', nullable — Deprecated, please use `cardConfig` instead. `VIRTUAL` - Virtual credit card `SINGLE_USE` - One-time virtual credit card (only one authorization allowed per card) `PHYSICAL` - Physical credit card `BLACK` - Physical black premium credit card `TRAVEL` - Virtual cards used specifically in travel industry related use cases
    - `cardConfig` string — The Pliant card configuration of this card. This describes all feature of this card in one single configuration, e.g. the type of the card and also the design of the card etc. It replaces the deprecated card `type`. Please refer to the [guide section](/docs/card-entity) to learn more about possible values.
    - `platformFee` boolean — Whether the card is used for the internal Pliant platform fee or not.
    - `cardDesignId` string, uuid — The unique identifier of the card design used for this specific card.
    - `cardDesignLogoName` string, nullable — The name of the card design used for this specific card.
    - `createdAt` string, date-time — The date-time when card was created.
    - `updatedAt` string, date-time — The date-time when card was updated.
  - `hasNextPage` boolean — Indicates whether there is a next page available.

## Other responses

- `400` — Bad Request. The API consumer sent a malformed request which could not be processed.
- `401` — Unauthorized. The API consumer is not authorized to access the requested resource.
- `403` — Forbidden. The API consumer is not allowed to access the requested resource.
- `429` — Too Many Requests. The API consumer has sent too many requests in a given amount of time. Please check our [API guidelines](/docs/pliant-api-guidelines#api-rate-limits).
- `500` — Internal Server Error. The request was not completed due to an internal error.

---

[API](https://skmtc.dev/getpliant/apis/pliant-customer-api.md) · [All operations](https://skmtc.dev/getpliant/apis/pliant-customer-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getpliant/pliant-customer-api/revisions/f3f589cfa718/schema)