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

Your business customer, cus_…, enabled for cards.

Query Parameters

cursor
string

The nextCursor from the previous page. Omit for the first page.

Response

A page of cardholders.

cardholders
object[]

Cardholders on this page.

nextCursor
string | null

Pass as cursor. null on the last page.

hasMore
boolean

Whether another page exists.