---
title: "List Cardholders"
method: GET
path: "/cardholders"
tags: ["Cardholders"]
---

# List Cardholders

`GET /cardholders`

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

## Query parameters

- `organizationId` string, uuid, required
- `status` 'INVITED' | 'ACTIVE' | 'DEACTIVATED'
- `email` string
- `fromDate` string, date-time
- `toDate` string, date-time
- `byDateField` 'registeredAt' | 'updatedAt', nullable
- `limit` integer
- `page` integer
- `sortBy` 'firstName' | 'lastName'
- `sortDirection` 'ASC' | 'DESC'

## Response `200`

Ok

- object
  - `data` object[]
    - `cardholderId` string, uuid, required — The ID of the cardholder.
    - `firstName` string, required — The first name of the cardholder. This will be printed on credit cards as the cardholder. It is important to note, that only the following characters are allowed for issuing cards: `A-Z`, `a-z`, `0-9`, `äöüÄÖÜ.-` Maximum length of the combination of first name and last name must not be more then 25 digits (to ensure its correctly displayed on the cards).
    - `lastName` string, required — The last name of the cardholder. This will be printed on credit cards as the cardholder. It is important to note, that only the following characters are allowed for issuing cards: `A-Z`, `a-z`, `0-9`, `äöüÄÖÜ.-` Maximum length of the combination of first name and last name must not be more then 25 digits (to ensure its correctly displayed on the cards).
    - `email` string, required — The email address of the cardholder. This will be used for email communication.
    - `status` 'INVITED' | 'ACTIVE' | 'DEACTIVATED' — The status of the cardholder.
    - `registeredAt` string, date-time — The date-time when cardholder was registered.
    - `updatedAt` string, date-time, nullable — The date-time when cardholder information was updated.
  - `hasNextPage` boolean

## Other responses

- `400` — unresolved $ref
- `401` — unresolved $ref
- `403` — unresolved $ref
- `429` — unresolved $ref
- `500` — unresolved $ref

---

[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)