Skip to main content
GET
/
partner
/
cardholders
List cardholders
curl --request GET \
  --url https://api.contro.me/v1/partner/cardholders \
  --header 'x-contro-api-key: <api-key>'
{
  "data": [
    {
      "id": "ch_abc123",
      "externalUserId": "user_42",
      "firstName": "Jane",
      "lastName": "Doe",
      "email": "jane@example.com",
      "phoneNumber": "+14155552671",
      "kycStatus": "approved",
      "status": "active",
      "createdAt": "2026-03-20T14:30:00Z",
      "metadata": {
        "plan": "premium"
      }
    }
  ],
  "hasMore": true,
  "nextCursor": "<string>"
}

Authorizations

​
x-contro-api-key
string
header
required

Partner API key (sk_live_* for production, sk_test_* for sandbox)

Query Parameters

​
cursor
string

Cursor for pagination

​
limit
integer
default:20

Number of items per page (1-100)

Required range: 1 <= x <= 100
​
status
string

Filter by cardholder status. One of: active, suspended, closed

Example:

"active"

​
kycStatus
string

Filter by KYC status. One of: pending, approved, rejected

Example:

"approved"

Response

List of cardholders

​
data
object[]
required
​
hasMore
boolean
required
​
nextCursor
string | null
required