Fetch Kits by Entity ID
Retrieves all card kits associated with a customer entity ID. Returns detailed information about each kit including card number (masked), encrypted card number, card status, card type, network type, product details, expiry date, and tier type. This is useful for listing all cards issued to a customer.
Authorization
tenantAuth The DCMS tenant name for multi-tenant isolation. Every API call must include this header to identify the client organization.
In: header
Header Parameters
The DCMS client or tenant name for multi-tenant isolation.
Request Body
application/json
Customer entity identifier to fetch kits for.
Response Body
application/json
curl -X POST "https://api.dcms.example.com/v1/kit-manager/fetchKitsByEntityId" \ -H "tenant: ACME_BANK" \ -H "Content-Type: application/json" \ -d '{ "entityId": "181223116" }'{
"result": [
{
"accountNo": "221000182316",
"bin": "817649",
"cardActivationDate": "2023-12-18T10:14:11.552+00:00",
"cardCategory": "DEBIT",
"cardNumber": "817649XXXXXX0662",
"cardStatus": "REPLACED",
"cardType": "PHYSICAL",
"changedDate": "2024-06-16T06:04:53.241+00:00",
"createdDate": "2023-12-18T10:14:11.552+00:00",
"encryptedCardNumber": "QSMJ9ceNJME5YibrPtYk6yeRxOcQr59+7A/1AgWTFiQ=",
"entityId": "181223116",
"expDate": "2028-11-30T00:00:00.000+00:00",
"kitNo": "10930010476",
"networkType": "RUPAY",
"productId": "RuPay_TRG_Classic_Debit_Physical",
"productName": "RuPay_TRG_Classic_Debit_Physical",
"tierType": "CLASSICONE"
},
{
"accountNo": "221000182316",
"bin": "817649",
"cardActivationDate": "2023-12-18T10:28:10.514+00:00",
"cardCategory": "DEBIT",
"cardNumber": "817649XXXXXX0670",
"cardStatus": "ACTIVE",
"cardType": "PHYSICAL",
"changedDate": "2024-06-16T06:04:53.246+00:00",
"createdDate": "2023-12-18T10:28:10.514+00:00",
"encryptedCardNumber": "qzeBE7wgKSWveIOIQtzgMieRxOcQr59+7A/1AgWTFiQ=",
"entityId": "181223116",
"expDate": "2028-11-30T00:00:00.000+00:00",
"kitNo": "10930010477",
"networkType": "RUPAY",
"productId": "RuPay_TRG_Classic_Debit_Physical",
"productName": "RuPay_TRG_Classic_Debit_Physical",
"tierType": "CLASSICONE"
}
],
"exception": null,
"pagination": null
}Fetch Kits by Account Number POST
Retrieves all card kits linked to a specific bank account number. Returns the account details along with all entities and their kits associated with that account. Supports an optional query parameter to include all cards including inactive and replaced ones.
Fetch Kits by Entity ID V2 POST
Enhanced version of Fetch Kits by Entity ID that returns encrypted card numbers using AES-GCM encryption. If the encrypted cardNumber field is configured for the bank, it will be encrypted using AES-GCM algorithm with a 16-byte random IV and 128-bit authentication tag. The encrypted value is Base64 encoded and combines the IV and ciphertext. Use the shared AES-GCM decryption key to decrypt the card number.