v1

latestOpenAPI 3.1.02026-07-2418201.6 MB

CKYC Bulk Download

post/v2/kyc/ckyc/bulk/download

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

batchNointeger

attemptinteger

referenceIdstring

bulkDecentroTxnIdstring

callbackTxnIdstring

originalCallbackTxnIdstring

timestampstring

creationTimestampstring

lastModificationTimestampstring

typestring

stagestring

statusstring

descriptionstring

Example response

{
  "batchNo": 1,
  "data": [
    {
      "identifier": "INKQMC06245500",
      "kycStatus": "SUCCESS",
      "message": "KYC Details from CKYC downloaded successfully.",
      "personalIdentifiableData": {
        "personalDetails": {
          "countOfDownloads": "134",
          "constitutionType": "1",
          "countOfUpdates": "4",
          "accountType": "Normal",
          "constituitonType": "Individual",
          "ckycNo": "00000000000000",
          "prefix": "Mr",
          "firstName": "ABC",
          "middleName": "DEF",
          "lastName": "QWE",
          "fullName": "Mr ABC DEF QWE",
          "fatherPrefix": "Mr",
          "fatherFname": "DEF",
          "fatherLname": "QWE",
          "fatherFullname": "Mr DEF QWE",
          "motherPrefix": "Mrs",
          "motherFname": "RTY",
          "motherFullname": "Mrs RTY QWE",
          "gender": "MALE",
          "dob": "01-01-2000",
          "pan": "ABCPE1234F",
          "permLine1": "SO address line 1",
          "permLine2": "address line 2",
          "permCity": "Bangalore",
          "permDist": "Bangalore",
          "permState": "KR",
          "permCountry": "IN",
          "permPin": "676102",
          "permPoa": "E-KYC Authentication",
          "permCorresSameflag": "Y",
          "corresLine1": "SO address line 1",
          "corresLine2": "address line 2",
          "corresCity": "Bangalore",
          "corresDist": "Bangalore",
          "corresState": "KR",
          "corresCountry": "IN",
          "corresPin": "676102",
          "corresPoa": "09",
          "mobCode": "91",
          "mobNum": "9999999999",
          "emailId": "abc@gmail.com",
          "decDate": "01-01-2015",
          "decPlace": "Bangalore",
          "kycDate": "********",
          "docSub": "Equivalent E-Document",
          "kycName": "********",
          "kycDesignation": "********",
          "kycBranch": "********",
          "kycEmpcode": "********",
          "numIdentity": "2",
          "numRelated": "0",
          "numImages": "3"
        },
        "identityDetails": {
          "identity": [
            {
              "sequenceNo": "1",
              "identityType": "Proof of Possession of Aadhaar",
              "identityNumber": "XXXXXXXX1840",
              "idVerificationStatus": "NO"
            }
          ]
        },
        "documentDetails": {
          "document": [
            {
              "imageCode": "Photograph",
              "imageType": "JPG",
              "imageData": "<XML details>"
            }
          ]
        }
      }
    }
  ],
  "attempt": 1,
  "referenceId": "3e3e4941-4acb-4d16-a465-cf941c0b4d08",
  "bulkDecentroTxnId": "5B1AC4E67D934FD0BC4B94A40192B66E",
  "callbackTxnId": "66B17D333672470DBB4CF42A569E4055",
  "originalCallbackTxnId": "66B17D333672470DBB4CF42A569E4055",
  "timestamp": "2025-07-10T14:32:52.784414",
  "creationTimestamp": "2025-07-10T11:55:43.000000",
  "lastModificationTimestamp": "2025-07-10T11:55:52.000000",
  "type": "BULK_CKYC_DOWNLOAD",
  "stage": "RECORDS_DOWNLOAD_SUCCESSFUL",
  "status": "COMPLETED",
  "description": "Records downloaded successfully."
}