Driving License Verification API

A Driving License Verification API is used to verify the authenticity and status of a driving license issued by transport authorities. It provides details such as holder name, validity status, issue date, and authorized vehicle classes for secure verification purposes.

API Details

Request URL

POST

https://g99.in/api/public/dl/verify

Request Body Parameters

Type	Name	Optional	Description
String	DrivingLicenceNumber	Required	Unique number of Driving Licence Number.
String	dob	Required	Date of birth available in Driving Licence

Sample Request Payload

request.json

{
  "DrivingLicenceNumber": "TN5420080003680",
  "dob": "01-01-2000"
}

Request Header Parameters

Type	Name	Value / Description	Optional
String	Content-Type	application/json	Required

Sample Code

request.php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://g99.in/api/public/dl/verify',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
  "DrivingLicenceNumber": "TN5420080003680",
  "dob": "01-01-2000"
}',
  CURLOPT_HTTPHEADER => array(
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

request.py

import requests
import json

url = "https://g99.in/api/public/dl/verify"

payload = json.dumps({
  "DrivingLicenceNumber": "TN5420080003680",
  "dob": "01-01-2000"
})
headers = {
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

request.cs

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://g99.in/api/public/dl/verify");
var content = new StringContent("{\r\n  \"DrivingLicenceNumber\": \"TN5420080003680\",\r\n  \"dob\": \"01-01-2000\"\r\n}", null, "application/json");
request.Content = content;
var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());

Response

HTTP status code 200

Key	Type	Description
valid	Boolean	Indicates whether the driving license details are valid and successfully verified.
message	String	Status or response message returned by the verification system.
active	String	Shows whether the driving license is currently active and usable.
owner	String	Name of the driving license holder.
issued	Date	Date on which the driving license was issued.
rto	String	Regional Transport Office (RTO) that issued the license.
ntpIssued	Date	Issue date of the Non-Transport vehicle license category.
ntpExpiry	Date	Expiry date of the Non-Transport vehicle license category.
tpIssued	Date	Issue date of the Transport vehicle license category.
tpExpiry	Date	Expiry date of the Transport vehicle license category.
type	String	Type/category of the driving license.
categories	Array	List of vehicle classes or categories authorized under the license.

Sample Response

Sample response for valid document

response.json

{
  "valid": true,
  "message": null,
  "active": true,
  "owner": "R*H*L  S R",
  "issued": "30-12-2019",
  "rto": "SRTO,NEDUMANGAD",
  "ntpIssued": "30-12-2019",
  "ntpExpiry": "16-06-2038",
  "tpIssued": null,
  "tpExpiry": null,
  "type": "NONTRANSPORT",
  "categories": []
}

Error Response

Parameter	Type	Description
status	Number	Unique error codes for different errors. Always available.
message	String	Error message describing the error. Always Available.
error	Boolean	True / False for different errors. Always available.

Error Codes

HTTP Status	Error Code	Error Message
200	2001	No Data Found.
400	4001	Malformed data or missing required parameter values.
503	5001	Request could not be processed. Please try again later.

Sample Error Response

response.json

{
  "message": "Malformed data or missing required parameter values.",
  "status": 4001,
  "error": True
}