Skip to main content
GET
List cardholders

Authorizations

Api-Key
string
header
required

Partner API key. Must carry the cards permission.

Headers

Api-Version
string
default:2026-09.1
required

The API version this request targets. 2026-09.1. See Versioning.

Pattern: ^\d{4}-\d{2}\.\d+$

Path Parameters

businessId
string
required

The enrolled business (cus_).

Example:

"cus_1Xb7cV4bN7mQ0wE3rT5y"

Query Parameters

cursor
string

The nextCursor from the previous page. Pages hold up to 20 cardholders.

Response

A page of cardholders.

cardholders
object[]

This page of cardholders.

nextCursor
string | null

Pass it as cursor for the next page. null on the last page.

hasMore
boolean

true when another page follows.