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/bulk?format=json' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic bWFkajU2YQ==' \
--header 'Cookie: _cfuvid=SaCVkFZICUs252lQ2tc24m6rQ2d38EDi8ptr3sp38bc-1762493749325-0.0.1.1-604800000' \
--data '[
{
"cardNumber": "24234234324345345345",
"statusLabel": "ACTIVE",
"extendedFields": {
"custom_card_name": "TOM",
"vehicle_number": "KA01B2020"
},
"mappedEntity": {
"type": "TILL",
"value": "rutuja_capillary"
},
"customFields": {
"vehicle_type": "Bike"
}
},
{
"cardNumber": "Test09000000000012end",
"statusLabel": "ACTIVE",
"extendedFields": {
"custom_card_name": "SOM",
"vehicle_number": "KA01B2021",
"card_requested_by": "rutuja_capillary"
},
"mappedEntity": {
"type": "TILL",
"value": "rutuja_capillary"
},
"customFields": {
"vehicle_type": "Car"
}
},
{
"cardNumber": "Test09000000000004end",
"statusLabel": "SUSPENDED",
"extendedFields": {
"custom_card_name": "DOM",
"vehicle_number": "KA01B2019"
},
"mappedEntity": {
"type": "TILL",
"value": "rutuja_capillary"
},
"customFields": {
"vehicle_type": "Cycle"
}
}
]'Example response
{
"response": [
{
"entityId": {
"extendedFields": {
"custom_card_name": "TOM",
"vehicle_number": "KA01B2020"
},
"customFields": {
"vehicle_type": "Bike"
},
"mappedEntity": {
"type": "TILL",
"value": "rutuja_capillary"
},
"cardNumber": "24234234324345345345",
"orgId": 100737,
"entityId": 75197372,
"statusLabel": "ACTIVE",
"transactionNotAllowed": false,
"activeAndDigital": false
},
"errors": [
{
"status": false,
"code": 3010,
"message": "Card number does not exists"
}
],
"warnings": []
},
{
"entityId": {
"cardId": 906641,
"customerId": 564845113,
"extendedFields": {
"card_requested_by": "rutuja_capillary",
"custom_card_name": "SOM",
"vehicle_number": "KA01B2021"
},
"customFields": {
"vehicle_type": "Car"
},
"mappedEntity": {
"type": "TILL",
"value": "rutuja_capillary",
"id": 75155373
},
"cardNumber": "Test09000000000012end",
"orgId": 100737,
"entityId": 75197372,
"statusLabelInfo": {
"createdOn": "2024-12-17",
"createdOnISO": "2024-12-17T06:52:31Z",
"description": "default",
"entityStatusId": 2,
"id": 494,
"isActive": true,
"label": "ACTIVE",
"orgId": 100737,
"updatedOn": "2025-06-19",
"updatedOnISO": "2025-06-19T11:01:01Z",
"status": "ACTIVE",
"type": "CARD",
"actions": {},
"default": true
},
"transactionNotAllowed": false,
"activeAndDigital": false
},
"errors": [],
"warnings": [
{
"status": false,
"code": 3039,
"message": "No update in status label"
}
]
},
{
"entityId": {
"cardId": 897683,
"customerId": 564845545,
"extendedFields": {
"custom_card_name": "DOM",
"vehicle_number": "KA01B2019"
},
"customFields": {
"vehicle_type": "Cycle"
},
"mappedEntity": {
"type": "TILL",
"value": "rutuja_capillary",
"id": 75155373
},
"cardNumber": "Test09000000000004end",
"orgId": 100737,
"entityId": 75197372,
"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": {
"createdBy": 75197372,
"actions": [],
"entityId": 897683,
"labelId": 496,
"orgId": 100737,
"entityType": "CARD",
"label": "SUSPENDED",
"prevLabel": "ACTIVE",
"prevLabelId": 494
},
"transactionNotAllowed": false,
"activeAndDigital": false
},
"errors": [],
"warnings": []
}
],
"totalCount": 3,
"failureCount": 1
}