Skip to main content
POST
/
partner
/
cards
Issue card
curl --request POST \
  --url https://api.contro.me/v1/partner/cards \
  --header 'Content-Type: application/json' \
  --header 'x-contro-api-key: <api-key>' \
  --data '
{
  "cardholderId": "ch_abc123",
  "programId": "prog_xyz",
  "idempotencyKey": "issue_card_user42_2026"
}
'
{
  "id": "card_def456",
  "status": "created",
  "cardholderId": "ch_abc123",
  "programId": "prog_xyz"
}

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"