Access Links2

Account Entries3

Accounting Categories7

Accounting Projects8

Accounting Suppliers6

Accounting Teams9

Accounting Transactions4

Accounting VAT Rates6

Beneficiaries2

Callbacks8

Card Accounts9

Card Controls2

Card Copilots4

Card Sensitive Data4

Cardholders8

Cards23

Cashback2

Custom Fields8

External Transfers8

Organizations3

Payments4

Receipt Automatching5

Receipts10

Statements6

Test Data Generator (Sandbox-only)3

Transactions11

Verification of Payee1

Cardholders

List Cardholders

Changed on Nov 3, 2026

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

get/cardholders

Request

Base URL
https://partner-api.getpliant.com/api
Auth
HTTP bearer
TypeScript
https://skmtc.dev/getpliant/apis/pliant-customer-api/docs/cardholders/get.ts
A function with typed inputs. Its response is checked against the schema.

Query parameters

organizationIdstring uuid required

The unique identifier of the organization.

status'INVITED' | 'ACTIVE' | 'DEACTIVATED' | 'CANCELLED'

The status to filter by.

emailstring

Filter by email address, case insensitive

fromDatestring date-time

Example:2024-07-19T15:00:00.000000Z

The from date to filter by as zero-offset UTC time. The date boundary is inclusive. Meaning we compare with >=.

toDatestring date-time

Example:2024-07-19T15:00:00.000000Z

The to date to filter by as zero-offset UTC time. The date boundary is inclusive. Meaning we compare with <=.

byDateField'registeredAt' | 'updatedAt' nullable

The date field to filter by if fromDate and toDate are present.

limitinteger

The maximum number of items to return per page. The default value if not provided is 100, the maximum allowed value is 1000.

pageinteger

The page number to return, starting with 0, this counts up to the total number of pages. The total number of pages is determined by the total number of records divided by the limit.

sortBy'firstName' | 'lastName'

The field to sort by.

sortDirection'ASC' | 'DESC'

The direction to sort by.

Response

hasNextPageboolean

Changes

Nov 3, 2026a4fbf7d068b4 Revision changes
- breaking
  the response's body type changed from no type to object for status
- breaking
  the response's body type changed from no type to object for status
- breaking
  the response's body type changed from no type to object for status
- breaking
  the response's body type changed from no type to object for status
- warning
  added the new CANCELLED enum value to the /// response property for the response status
- info
  added the new enum value CANCELLED to the query request parameter status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status

Operation history

List Cardholders

Request

Query parameters

Response 200OK

Changes

Response