Skip to main content
POST
/
v2
/
verification
/
driving-licence
Verify Driving Licence (v2)
curl --request POST \
  --url https://bgv.konnectnxt.com/api/v2/verification/driving-licence \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "dl_number": "MH0920220028511",
  "dob": "05-05-2000"
}
'
{
  "status": "success",
  "code": 200,
  "message": "Operation completed successfully",
  "data": {
    "state": "West Bengal",
    "status": "id_found",
    "user_dob": "19-02-2002",
    "dl_number": "WB0120240098453",
    "user_image": "",
    "expiry_date": "19-02-2042",
    "issued_date": "22-08-2024",
    "endorse_date": "NA",
    "user_address": {
      "pin": "700091",
      "type": "Permanent",
      "state": "West Bengal",
      "country": "India",
      "district": "Kolkata",
      "addressLine1": "Flat 4B, Salt Lake Sector V",
      "completeAddress": "Flat 4B, Salt Lake Sector V, Kolkata, West Bengal, 700091"
    },
    "endorse_number": "NA",
    "status_details": {
      "to": "",
      "from": "",
      "remarks": ""
    },
    "user_full_name": "ARJUN DEV ROY",
    "name_match_score": "88.50",
    "user_blood_group": "O+",
    "father_or_husband": "BISWAJIT ROY",
    "transport_validity": {
      "to": "NA",
      "from": "NA"
    },
    "non_transport_validity": {
      "to": "19-02-2042",
      "from": "22-08-2024"
    },
    "vehicle_category_details": [
      {
        "cov": "LMV-NT",
        "covType": "non-transport",
        "issueDate": "22-08-2024",
        "expiryDate": "19-02-2042"
      },
      {
        "cov": "MCWG",
        "covType": "non-transport",
        "issueDate": "22-08-2024",
        "expiryDate": "19-02-2042"
      }
    ]
  },
  "credits_used": 7,
  "credits_remaining": 492
}

​
Overview

The Driving Licence Verification v2 API validates Driving Licence details using Driving Licence number, full name, and date of birth. It returns comprehensive information including personal details, registered address, current status, and class of vehicle.

​
Key Features

  • Complete Verification: Validates Driving Licence number, name, and date of birth
  • Comprehensive Details: Returns full name, address, contact information
  • Real-time Validation: Instant verification in under 2 seconds
  • Masked Data: Secure display of sensitive information

​
What’s New in v2

  • Enhanced Data: More comprehensive personal and address details
  • Better Validation: Full name and DOB matching for accuracy
  • Vehicle Response: Optimized for quicker verification
  • Consistent Format: Unified response structure across all v2 APIs
Data Availability: Driving Licence status and cardholder name are always returned. Additional details such as address, contact information, and vehicle class status are provided when available in the records.

Authorizations

​
Authorization
string
header
required

API key issued by KonnectNXT. Pass as Authorization: Bearer <your_api_key>.

Body

application/json
​
dl_number
string
required

DL Number must be in the format AA00XXXXXXXXXXX and not contain all identical digits in the numeric part. (Max Length: 16)

Maximum string length: 16
Example:

"MH0920220028511"

​
dob
string
required

Date of Birth in DD-MM-YYYY format.

Pattern: ^\d{2}-\d{2}-\d{4}$
Example:

"05-05-2000"

Response

Successful response with Driving Licence details.

​
status
enum<string>
required

Overall status of the API

Available options:
success,
error
​
code
integer
required

HTTP status code

Example:

400

​
message
string
required

Description of the response or error

Example:

"Invalid request parameters"

​
data
object
required
​
credits_used
integer
required

Represents the total number of credits used in this request.

Example:

3

​
credits_left
integer
required

Represents the remaining credits available for use.

Example:

4040