put https://{host}/v2/card?format=json
Lets you add a new card number to a card series and provide card details.
Once the card is added, you can issue it to a customer using customers /changeIdentifier API.
Example request
curl --location --request PUT 'https://eu.api.capillarytech.com/v2/card' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic Z2VvcmdlLmRvY2RlbW86MmQ1OTNhMjI2MTk1OGE2NWI5ZjAxMzU5NGIwNDllZTk=' \
--header 'Cookie: _cfuvid=YyYQB5XUwCZmLtgRlu60lc4n5_3PDiTtwCCXj6_8V3g-1762771226384-0.0.1.1-604800000' \
--data '{
"seriesId": 121212,
"cardNumber": "Test09000000000105end",
"cardExternalId": "cardtest22",
"statusLabel": "SUSPENDED",
"statusInfo": {
"reason": "Card is generated but not issued"
},
"customFields": {
"city": "Bangalore"
}
}'Example response
{
"cardId": 920897,
"customerId": 566135941,
"cardExternalId": "cardtest22",
"customFields": {
"city": "Bangalore"
},
"cardNumber": "Test09000000000105end",
"seriesId": 121212,
"orgId": 100737,
"entityId": 75197941,
"statusLabel": "SUSPENDED",
"statusLabelInfo": {
"createdOn": "2024-12-17",
"createdOnISO": "2024-12-17T06:52:31Z",
"description": "default",
"entityStatusId": 4,
"id": 496,
"isActive": true,
"label": "SUSPENDED",
"orgId": 100737,
"updatedOn": "2025-06-19",
"updatedOnISO": "2025-06-19T11:01:01Z",
"status": "SUSPENDED",
"type": "CARD",
"actions": {},
"default": true
},
"statusInfo": {
"reason": "Card is generated but not issued",
"createdBy": 75197941,
"actions": [],
"entityId": 920897,
"labelId": 496,
"orgId": 100737,
"entityType": "CARD",
"label": "SUSPENDED",
"prevLabel": "ACTIVE",
"prevLabelId": 494
},
"transactionNotAllowed": false,
"activeAndDigital": false,
"warnings": []
}