v1

latestOpenAPI 3.0.2EULA2026-07-143221521.2 MB

Cards

Assign free card

Assign a free card to a customer. This action is limited to one card per card type per customer. If your project allows customers to have multiple cards of one type, use PUT /cards/{card_id} instead. See Assign card to customer for details.

post/cards/actions/assign-free-card

Headers

Accept-Languagestring

The unique ID of the language code by ISO 639-1.

Request body

card_type_idstring required

The unique ID of the card type.

customer_idstring required

The unique ID of the card holder.

card_numberstring

Card number.

Example request

{
  "card_type_id": "83d1d11ea3884a5d33253fe214",
  "customer_id": "8ea2591121e636086a4a9c0992",
  "card_number": "1000000000016"
}

Response

Example response

{
  "data": {
    "card_id": "8fd73167342d06899c4c015320"
  }
}