Update cardholder

curl --request PATCH \ --url https://api.contro.me/v1/partner/cardholders/{id} \ --header 'Content-Type: application/json' \ --header 'x-contro-api-key: <api-key>' \ --data ' { "email": "jane.doe@newdomain.com", "phoneNumber": "+14155552671" } '

{ "id": "ch_abc123", "externalUserId": "user_42", "firstName": "Jane", "lastName": "Doe", "email": "jane@example.com", "phoneNumber": "+14155552671", "kycSource": "api", "kycStatus": "approved", "status": "active", "createdAt": "2026-03-20T14:30:00Z" }

Authorizations

x-contro-api-key

string

header

required

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

Path Parameters

string

required

Cardholder ID

Example:

"ch_abc123"

Body

application/json

string<email>

Valid email address

Example:

"jane.doe@newdomain.com"

phoneNumber

string

E.164 formatted phone number

Example:

"+14155552671"

Response

Cardholder updated

string

required

Contro cardholder ID

Example:

"ch_abc123"

externalUserId

string

required

Your unique identifier for this user

Example:

"user_42"

firstName

string

required

Cardholder's first name

Example:

"Jane"

lastName

string

required

Cardholder's last name

Example:

"Doe"

string

required

Email address

Example:

"jane@example.com"

phoneNumber

string | null

required

E.164 formatted phone number, or null if not provided

Example:

"+14155552671"

kycSource

string

required

KYC submission method. One of: api, sumsub, web

Example:

"api"

kycStatus

string

required

KYC verification status. One of: pending, approved, rejected

Example:

"approved"

status

string

required

Cardholder account status. One of: active, suspended, closed

Example:

"active"

createdAt

string

required

ISO 8601 creation timestamp

Example:

"2026-03-20T14:30:00Z"