Ekyc Apis Docs | Nerotix

Request URL

POST

https://ekyc.nerotix.in/api/v1/service/dl/verify

Authentication Required REQUIRED

Pass a valid Bearer Token in the Authorization header with every request.

Authorization: Bearer YOUR_BEARER_TOKEN

Parameters

Name	Type	Description
dlNumber required	string	The Driving Licence number to be verified. Must follow the state-wise DL number format.
dob required	string	Date of Birth (YYYY-MM-DD)

Request Body

application/json

{
    "dlNumber": "ABC123456",
    "dob": "1990-01-01"
}

Response Examples

API Response

Sample responses returned by the Driving License Verification API.

Successful Response

Success

Driving License details successfully verified

HTTP 200 OK

application/json

{
    "success": true,
    "statusCode": 1,
    "message": "Verification Successfully Completed!",
    "data": {
        "txn_id": "T20251009120821NCQZ",
        "dl_number": "MP3020220000372",
        "dob": "1994-05-27",
        "dl_status": "Driving License number is Valid",
        "dl_validity": {
            "non_transport": {
                "to": "2034-05-26",
                "from": "2022-01-24"
            },
            "hazardous_valid_till": null,
            "transport": {
                "to": null,
                "from": null
            },
            "hill_valid_till": null
        },
        "badge_details": [
            {
                "badge_issue_date": null,
                "badge_no": null,
                "class_of_vehicle": [
                    "MCWG",
                    "LMV"
                ]
            }
        ],
        "name": "MANOJ KUMAR RATHOR",
        "father_or_husband_name": "RAMKISHOR RATHOR",
        "date_of_issue": "2022-01-24",
        "date_of_last_transaction": null,
        "address": "HOUSE NO. 166, WARD NO.4 GWALIOR ROAD, MEHGAON BHIND MADHYA PRADESH, Madhya Pradesh, 477557",
        "address_list": [
            {
                "complete_address": "HOUSE NO. 166, WARD NO.4 GWALIOR ROAD, MEHGAON BHIND MADHYA PRADESH, Madhya Pradesh, 477557",
                "type": "permanent",
                "split_address": {
                    "district": [
                        "BHIND"
                    ],
                    "state": [
                        [
                            "MADHYA PRADESH",
                            "MP"
                        ]
                    ],
                    "city": [
                        "MEHGAON"
                    ],
                    "pincode": "477557",
                    "country": [
                        "IN",
                        "IND",
                        "INDIA"
                    ],
                    "address_line": "HOUSE NO.166,WARD NO.4 GWALIOR ROAD"
                }
            }
        ],
        "photo": "https://cf-prod-payoutbankvalidationsvc-biometric-image.s3.ap-south-1.amazonaws.com/identityVerification/DRIVING_LICENSE/2911508_photo.jpeg.jpeg?...",
        "cov_details": []
    }
}

Invalid Response

Invalid

Driving License is Invalid

HTTP 200 OK

application/json

{
    "success": true,
    "statusCode": 1,
    "message": "Verification Successfully Completed!",
    "data": {
        "txn_id": "T20251009120821NCQZ",
        "dl_number": null,
        "dob": null,
        "dl_status": "Driving License number is Invalid",
        "dl_validity": {
            "non_transport": {
                "to": null,
                "from": null
            },
            "hazardous_valid_till": null,
            "transport": {
                "to": null,
                "from": null
            },
            "hill_valid_till": null
        },
        "badge_details": null,
        "name": null,
        "father_or_husband_name": null,
        "date_of_issue": null,
        "date_of_last_transaction": null,
        "address": null,
        "address_list": null,
        "photo": null,
        "cov_details": null
    }
}

Note Please keep the following points in mind while integrating this API.

The API endpoint should be accessed via a POST request.
Ensure that the request is properly validated and sanitized to prevent security vulnerabilities.
Implement proper error handling on the client side to display user-friendly error messages based on the 'statusCode' and 'message' fields in the response.
Always include a valid Bearer Token in the Authorization header when making API requests.