Skip to main content
PATCH
Update cardholder

Authorizations

x-contro-api-key
string
header
required

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

Path Parameters

id
string
required

Cardholder ID

Example:

"ch_abc123"

Body

application/json
email
string<email>

Valid email address

Example:

"jane.doe@newdomain.com"

phoneNumber
string

E.164 formatted phone number

Example:

"+14155552671"

residenceCountryCode
string

Residence country (ISO 3166-1 alpha-2)

Required string length: 2
Example:

"US"

residenceStateProvince
string

Residence state/province

residenceCity
string

Residence city

residenceAddressDetail
string

Residence address

postalCode
string

Postal code

Response

Cardholder updated

id
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"

email
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"