Fetch Kits by Account Number
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.
Authorization
tenantAuth The DCMS tenant name for multi-tenant isolation. Every API call must include this header to identify the client organization.
In: header
Query Parameters
Set to true to include all cards including inactive and replaced cards. Default returns only active cards.
Header Parameters
The DCMS client or tenant name for multi-tenant isolation.
Request Body
application/json
Bank account number to look up associated kits for.
Response Body
application/json
curl -X POST "https://api.dcms.example.com/v1/kit-manager/fetchKitsByAccountNo" \ -H "tenant: ACME_BANK" \ -H "Content-Type: application/json" \ -d '{ "accountNo": 8000000 }'{
"result": {
"accountNo": 8000000,
"accountStatus": "ACTIVE",
"accountType": "SAVING",
"entity": [
{
"entityId": "req11",
"isPrimary": false,
"kitInfo": [
{
"bin": "608040",
"cardCategory": "DEBIT",
"cardNumber": "608040XXXXXX5750",
"cardStatus": "INACTIVE",
"cardType": "VIRTUAL",
"createdDate": "2023-12-19T08:21:11.901+00:00",
"entityId": "req11",
"expDate": "2029-07-31T00:00:00.000+00:00",
"kitNo": "4240171532",
"networkType": "RUPAY",
"productId": "2003_VIRTUAL",
"productName": "2003_VIRTUAL"
}
]
}
]
},
"exception": null,
"pagination": null
}Fetch CIF by Masked Card Number POST
Retrieves the CIF (Customer Information File) number associated with a masked card number. The masked card number should follow the format where the first 6 and last 4 digits are visible and the middle digits are replaced with X characters. Returns a list of entity IDs since multiple customers could potentially be associated with the same masked card pattern.
Fetch Kits by Entity ID POST
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.