Customer Verification

Businesses can integrate with Decentro to verify the ID number of their customers or extract information from a public KYC ID. The major benefit of this offering is that customers do not have to upload or share any document images, yet the business can seamlessly onboard customers with very few hassles.

😁

Regex Builder

Developers can refer to this page to build regex-checks that is based on the same checks Decentro performs before validating a document number from a government repository. This will help avoid uneccessary validation errors caused by invalid inputs from users.

Supported Documents

Our Document Verification API supports a good number of widely used customer documents like PAN, RC, DL and Voter ID. Below is the list of all documents that can verified using Decentro's Document Verification API:

Supported DocumentsDescription
PANA 10-character alphanumeric PAN number
Registration CertificateRC number of the motor vehicle
Driving LicenseA 15 / 16 character driving license number
Voter IDThe Voter ID number found in the Electors Photo Identity Card or Election Card

πŸ“˜

Document Type Enumeration Standardized

In the request body, "document_type" parameter will only consider capital letters & underscore.

The special character's not allowed -!@#$%^&*()~{}|<>,.:;"'?/+=

Accepted Enumeration Examples -

  1. PAN
  2. PAN_DETAILED

Not Accepted Enumeration Examples -

  1. pan
  2. PAN-DETAILED

1. PAN

PAN Stands for Permanent Account Number and it is a ten-digit alphanumeric number issued by the Income Tax Department of India.

There are two types of PAN cards -

Individual PANBusiness PAN
A ten-digit alphanumeric ID numberA ten-digit alphanumeric ID number
It belongs to a personIt belongs to a business
{
    "reference_id": "Individual PAN",
    "document_type": "PAN",
    "id_number": "XXXXXXXXXX",
    "consent": "Y",
    "consent_purpose": "Checking individual PAN details"
}
{
    "kycStatus": "SUCCESS",
    "status": "SUCCESS",
    "message": "PAN details retrived successfully.",
    "kycResult": {
        "idNumber": "ABCDE1234F",
        "idStatus": "VALID",
        "name": "MANISH GUPTA"
    },
    "responseKey": "success_pan",
    "responseCode": "S00000",
    "requestTimestamp": "2023-08-30 16:30:33.345177 IST (GMT +0530)",
    "responseTimestamp": "2023-08-30 16:30:33.453545 IST (GMT +0530)",
    "decentroTxnId": "DECXXXXXXXXXXXXXXXXXXXXXXXXXXX"
}
{
    "reference_id": "Business PAN",
    "document_type": "PAN",
    "id_number": "XXXXXXXXXX",
    "consent": "Y",
    "consent_purpose": "Checking Business PAN details"
}
{
  "kycStatus": "SUCCESS",
  "status": "SUCCESS",
  "message": "KYC Details for PAN retrieved successfully",
  "kycResult": {
    "idNumber": "ABCDE12345",
    "idStatus": "VALID",
    "name": "AMAZON SELLER SERVICES PRIVATE LIMITED"
  },
  "responseKey": "success_pan",
  "responseCode": "S00000",
  "requestTimestamp": "2020-07-24 21:25:20.778016 IST (GMT +0530)",
  "responseTimestamp": "2020-07-24 21:25:21.991470 IST (GMT +0530)",
  "decentroTxnId": "DECXXXXXXXXXXXXXXXXXXXXXXXXXXX"
}

πŸ˜ƒ

PAN Detailed - Individual and Business PAN

Decentro has the feature to provide detailed information for both the PANs by passing PAN_DETAILED in the document_type parameter in the request body

{
  "reference_id": "Fetching PAN-Detailed",
  "document_type": "PAN_DETAILED",
  "id_number": "XXXXXXXXXX",
  "consent": "Y",
  "consent_purpose": "To Fetch PAN-Detailed"
}
{
  "referenceId": "Fetching PAN-Detailed",
  "kycStatus": "SUCCESS",
  "status": "SUCCESS",
  "message": "KYC Details for PAN retrieved successfully",
  "kycResult": {
    "idNumber": "XXXXXXXXXX",
    "idStatus": "VALID",
    "panStatus": "VALID",
    "lastName": "PRIVATE LIMITED",
    "firstName": "AMAZON SELLER SERVICES",
    "fullName": "AMAZON SELLER SERVICES PRIVATE LIMITED",
    "idHolderTitle": "M/S",
    "idLastUpdated": "20/04/2021",
    "aadhaarSeedingStatus": "Y"
  },
  "responseKey": "success_pan",
  "responseCode": "S00000",
  "requestTimestamp": "2020-07-24 21:25:20.778016 IST (GMT +0530)",
  "responseTimestamp": "2020-07-24 21:25:21.991470 IST (GMT +0530)",
  "decentroTxnId": "DECXXXXXXXXXXXXXXXXXXXXXXXXXXX"
}

2. RC

RC stands for Registration Certificate and is commonly known as RC in India. It is an official document stating that your motor vehicle has been registered with the Indian Government.

RC is one of the widely used documents for KYC (Know Your Customer) purposes.

{
  "reference_id": "RC Document Verification",
  "document_type": "RC",
  "id_number": "XXXXXXXXXXX",
  "consent": "Y",
  "consent_purpose": "To verify RC document"
}
{
  "kycStatus": "SUCCESS",
  "status": "SUCCESS",
  "message": "Valid Authentication",
  "kycResult": {
    "blacklistStatus": "<blacklist_reason",
    "chassisNumber": "MD2A14AZ2XXXXXXX",
    "status": "ACTIVE",
    "registrationDate": "19-Dec-2012",
    "class": "M-Cycle/Scooter(2WN)",
    "maker": "BAJAJ AUTO LTD DISCOVER 100 BSIII",
    "ownerName": "<owner Name>",
    "registrationNumber": "<rc number>",
    "reportId": "<report id>",
    "engineNumber": "JBZXXXXXXX",
    "fuelType": "PETROL",
    "fitUpto": "18-Dec-2027",
    "insuranceValidity": "22-Nov-2013",
    "pollutionControlValidity": "NA",
    "licenseAddress": "<license address>",
    "taxUpto": "22-Nov-2024"
  },
  "responseKey": "success_rc",
  "responseCode": "S00000",
  "requestTimestamp": "2020-07-24 21:25:20.778016 IST (GMT +0530)",
  "responseTimestamp": "2020-07-24 21:25:21.991470 IST (GMT +0530)",
  "decentroTxnId": "DECXXXXXXXXXXXXXXXXXXXXXXXXXXX"
}

πŸ˜ƒ

RC Detailed

Decentro has the feature to provide detailed information for RC (Registration Certificate) by passing RC-Detailed in the document_type parameter in the request body

{
  "reference_id": "RC-Detailed Document Verification",
  "document_type": "RC_DETAILED",
  "id_number": "XXXXXXXXXXX",
  "consent": "Y",
  "consent_purpose": "To verify RC document"
}
{
  "kycStatus": "SUCCESS",
  "status": "SUCCESS",
  "message": "Valid Authentication",
  "kycResult": {
    "blacklistStatus": "<blacklist_reason",
    "status": "ACTIVE",
    "registrationDate": "10-May-2015",
    "registrationAddress": "<<registration_address>>",
    "registrationNumber": "<<registration_number>>",
    "ownerName": "<<owner's name>>",
    "ownerFatherName": "<<owner's father's name>>",
    "ownerPermanentAddress": "<<owner's permanent address>>",
    "ownerPresentAddress": "<<owner's present address>>",
    "ownerSerialNumber": "1",
    "chassisNumber": "DSBCNA51HXXXXXXX9",
    "bodyType": "TRUCK (OPEN BODY)",
    "class": "Goods Carrier(HGV)",
    "category": "HGV",
    "color": "APR",
    "engineCubicCapacity": "30.00",
    "numberCylinders": "5",
    "unladenWeight": "1080",
    "grossWeight": "1500",
    "wheelbase": "<<vehicle's wheelbase size in mm>>",
    "engineNumber": "XXXXXXXXXXXXXXXXXX",
    "manufacturedMonthYear": "5/20XX",
    "makerDescription": "HYUNDAI MOTOR INDIA LTD / HYUNDAI SANTRO",
    "maker": "Hyundai",
    "fuelType": "DIESEL",
    "nocDetails": [
      "noc details, if any"
    ],
    "normsDescription": "Bharat Stage VI",
    "financer": "<<XYZ BANK LTD>>",
    "financier": "<<ABC COMPANY>>",
    "fitUpto": "1-JAN-20XX",
    "insuranceUpto": "25-July-2022",
    "insuranceDetails": "<<insurance company name>>",
    "insuranceValidity": "<<insurance validity date>>",
    "npCertificateIssuedBy": "Secretary RTA, XXXX",
    "npCertificateNumber": "NP/DL/XX/XXXXXX/XXXX",
    "npCertificateValidity": "05-May-20XX",
    "permitIssueDate": "02-Feb-2016",
    "permitNumber": "XXX/NP/2016/XXXXX",
    "permitType": "National Permit [HEAVY GOODS VEHICLE]",
    "permitValidFrom": "02-Feb-2016",
    "permitValidUpto": "13-Jun-2021",
    "pollutionControlNumber": "XXXXXXXXXXXXXXXX",
    "pollutionControlValidity": "19-Apr-2020",
    "seatingCapacity": "3",
    "sleepingCapacity": "0",
    "standingCapacity": "0",
    "statusAsOn": "<<Date of RC verification>>",
    "taxUpto": "<<Date to which the tax has been paid>>"
  },
  "responseKey": "success_rc",
  "responseCode": "S00000",
  "requestTimestamp": "2020-07-24 21:25:20.778016 IST (GMT +0530)",
  "responseTimestamp": "2020-07-24 21:25:21.991470 IST (GMT +0530)",
  "decentroTxnId": "DECXXXXXXXXXXXXXXXXXXXXXXXXXXX"
}

3. Driving License

It is a permit or permission to drive a specific category of vehicle on the road like two-wheeler, four-wheeler, etc. It is an official document issued by the Government of India to drive the vehicle you own specifying that the vehicle category has been mentioned on the Driving License.

πŸ—’οΈ

Driving License - DOB Parameter

It is important to pass dob parameter in the request body to verify Driving License. Sample dob format - YYYY-MM-DD

{
  "reference_id": "Driving License Document Verification",
  "document_type": "DRIVING_LICENSE",
  "id_number": "XXXXXXXXXXX",
  "dob": "yyyy-mm-dd",
  "consent": "Y",
  "consent_purpose": "To verify Driving License document"
}
{
  "status": "SUCCESS",
  "kycStatus": "SUCCESS",
  "message": "KYC Details for Driving License retrieved successfully.",
  "kycResult": {
    "addresses": [
      {
        "addressLine": "HNO-8 A2/B MIG FLATS",
        "completeAddress": "HNO-8 A2/B MIG FLATS, PASCHIM VIHAR, DELHI",
        "country": "India",
        "district": "PASCHIM VIHAR,DELHI",
        "pin": "110063",
        "state": "Delhi",
        "type": "Present"
      },
      {
        "addressLine": "HNO-8 A2/B MIG FLATS",
        "completeAddress": "HNO-8 A2/B MIG FLATS, PASCHIM VIHAR,DELHI",
        "country": "India",
        "district": "PASCHIM VIHAR,DELHI",
        "pin": "110063",
        "state": "Delhi",
        "type": "Permanent"
      }
    ],
    "allClassOfVehicle": [
      {
        "cov": "ADPVEH",
        "expiryDate": "",
        "issueDate": "01-03-2011"
      }
    ],
    "bloodGroup": "U",
    "dateOfBirth": "01-03-1976",
    "drivingLicenseNumber": "DL-XXXXXXXXXXXXX",
    "endorseDate": "",
    "endorseNumber": "",
    "fatheusband": "BODH SHAH",
    "issueDate": "01-03-2011",
    "name": "ANURAG SHAH",
    "state": "Delhi",
    "status": "Active",
    "statusDetails": {
      "from": "",
      "remarks": "",
      "to": ""
    }
  },
  "responseKey": "success_driving_license",
  "responseCode": "S00000",
  "requestTimestamp": "2020-06-02 12:42:34.093924 IST (GMT +0530)",
  "responseTimestamp": "2020-06-02 12:42:35.970804 IST (GMT +0530)",
  "decentroTxnId": "DECXXXXXXXXXXXXXXXXXXXXXXXXXXX"
}

4. Voter ID

Voter ID is also known as Election Card or Electors Photo Identity Card. It is an official document issued by the Election Commission of India to adults above age 18.

{
  "reference_id": "VOTERID Document Verification",
  "document_type": "VOTER_ID",
  "id_number": "XXXXXXXXXXX",
  "consent": "Y",
  "consent_purpose": "To verify VOTER_ID document"
}
{
  "status": "SUCCESS",
  "kycStatus": "SUCCESS",
  "message": "KYC Details for Voter ID retrieved successfully.",
  "kycResult": {
    "epicNo": "XXXXXXXXXX",
    "name": "Loganathan -",
    "nameInVernacular": null,
    "gender": "M",
    "emailId": "",
    "mobileNumber": "9952141009",
    "age": 66,
    "dateOfBirth": "Thu Nov 19 00:00:00 UTC 1953",
    "relativeName": "kanapalli -",
    "relativeRelationType": "F",
    "houseNumber": "35",
    "partOrLocationInConstituency": "Chennai Girls Higher Secondary School No,5 School Road,Perambur,Chennai-600011.",
    "partNumberOrLocationNumberInConstituency": "12",
    "district": "CHENNAI",
    "state": "Tamil Nadu",
    "state_code": "S22",
    "parliamentaryConstituency": "CHENNAI NORTH",
    "assemblyConstituency": "Thiru-Vi-Ka-Nagar",
    "pollingBoothCoordinates": "0.0,0.0",
    "pollingBoothAddress": "Chennai Girls Higher Secondary School No,5 School Road,Perambur,Chennai-600011.",
    "pollingBoothNumber": "12",
    "sectionOfConstituencyPart": "2",
    "cardSerialNumberInPollingList": "701",
    "id": "S220150012020701",
    "lastUpdateDate": null,
    "status": "N"
  },
  "responseKey": "success_voterid",
  "responseCode": "S00000",
  "requestTimestamp": "2020-06-02 12:45:08.928726 IST (GMT +0530)",
  "responseTimestamp": "2020-06-02 12:45:09.194639 IST (GMT +0530)",
  "decentroTxnId": "DECXXXXXXXXXXXXXXXXXXXXXXXXXXX"
}