Skip to main content
POST
Issue card

Authorizations

x-contro-api-key
string
header
required

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

Body

application/json
cardholderId
string
required

ID of the cardholder to issue the card to

Minimum string length: 1
Example:

"ch_abc123"

programId
string
required

Card program to issue from

Minimum string length: 1
Example:

"prog_xyz"

idempotencyKey
string

Unique key to prevent duplicate card issuance

Example:

"issue_card_user42_2026"

Response

Card issued

id
string
required

Newly issued card ID

Example:

"card_def456"

status
string
required

Initial card status

Example:

"created"

cardholderId
string
required

Cardholder this card belongs to

Example:

"ch_abc123"

programId
string
required

Card program used

Example:

"prog_xyz"