v1

latestOpenAPI 3.1.02026-07-2418201.6 MB

CKYC Bulk Search API

post/v2/kyc/ckyc/bulk/search

Request body

reference_idstring

Any unique ID assigned by you for this API request.

consentboolean

true/false based on if your customer has given you the consent for validating his CKYC based on this. Mandatory as per regulation.

purposestring

The purpose of taking this consent from your customer. Mandatory as per regulation. (>20 characters)

Response

200

Example response

{
  "attempt": 1,
  "referenceId": "04e83fc3-ea09-4ad3-bf6c-027c0367196e",
  "bulkDecentroTxnId": "F2EC6FDEA9184933B7D1E8C964317463",
  "callbackTxnId": "32B89BC544DD4F0182A41F06F608ED29",
  "originalCallbackTxnId": "32B89BC544DD4F0182A41F06F608ED29",
  "timestamp": "2025-07-16T13:03:51.309017",
  "creationTimestamp": "2025-07-16T12:53:43.000000",
  "lastModificationTimestamp": "2025-07-16T12:53:43.000000",
  "type": "BULK_CKYC_SEARCH",
  "stage": "RECORDS_SEARCH_SUCCESSFUL",
  "status": "COMPLETED",
  "description": "Records searched successfully.",
  "batchNo": 1,
  "data": [
    {
      "documentType": "PAN",
      "idNumber": "ABCDE0383F",
      "message": "KYC Details from CKYC retrieved successfully.",
      "kycStatus": "SUCCESS",
      "kycResult": {
        "ckycId": "XXXXXXXXXX3901",
        "ckycReferenceId": "ABCDEF01111100",
        "fullName": "ABC",
        "identityDetails": {
          "identity": [
            {
              "type": "PAN",
              "status": "03"
            }
          ]
        }
      }
    }
  ]
}