Request Method :: POST

Description: The DL Verification API verifies driving license details.

Headers

---

Content-Type: application/JSON

header_secrets:  To be shared during integration by ISU Team

pass_key:  To be shared during integration by ISU Team

Request Body Parameters

Parameters	Parameter description with validations and examples	Data type	Mandatory/Optional
number	DL Number. E.g. - "MH0120130001960"	String	Mandatory
dob	Date of Birth of the DL Holder. E.g. - "05/10/1994"	string	Mandatory

Sample Request Body

---

{ "number": "MH0120130001960", "dob": "05/10/1994" }

Encrypted Sample Request Body

---

{ "RequestData": "/L4NlEgKPodkB7H0yPC4K24vWAtqTClaMqFqId/ noNegwoF7FEUUygNHTrVLUNJqAuR6SOlp2erhDl211f6nJQ==" }

Response Body Parameters

Parameters	Parameter description with examples	Data type
status	Status message of the response	String
statusCode	Status code of the response	integer
statusDesc	Description of the status	string
data	Contains the main response data	Object
result	Result of the API response	Object
badgeDetails	Information about the badge issued	String
badgeIssueDate	Date when the badge was issued	String
badgeNo	Unique identification number of the badge	String
classOfVehicle	Type/category of the vehicle	String
detailsOfDrivingLicence	Complete details related to the drivinglicense	String
address
addressList	list of the address	string
completeAddress	Full address of the license holder	String
splitAddress	Address split into different components	string
addressLine	Street or locality details	String
splitAddress	Contains detailed address breakdown	Object
city	City of residence	String
country	Country of residence	String
district	District of residence	String
pincode	Postal code of the license holder’s address	String
state	State of residence	String
type	Type of license	String
covDetails	Details about the class of vehicles covered by the license	String
dateOfIssue	Date when the license was issued	String
dateOfLastTransaction	Last date transaction	String
fatherOrHusbandName	Name of the license holder’s father or husband	String
lastTransactedAt	Location where the last transaction was processed	String
name	Full name of the license holder	string
photo	The holder's photo	string
status	Current status of the driving license	String
dlNumber	Unique driving license number	String
dlValidity	Expiry date of the driving license	String
hazardousValidTill	Validity period for hazardous vehicle operation	String
hillValidTill	Validity period for hill driving authorization	string
nonTransport	Validity period for non-transport vehicles	string
from	Start date of the license validity	string
to	End date of the license validity	string
transport	Validity period for transport vehicles	string
dob	Date of birth of the license holder	string
error	Name of the error (Only for FAILED)	string
message	Error message (Only for FAILED)	string

Sample Response Body

---

SUCCESS:

{ "status": "SUCCESS", "statusCode": 0, "statusDesc": "Successfully fetched driver license details", "data": { "result": { "badgeDetails": [ { "badgeIssueDate": "", "badgeNo": "", "classOfVehicle": [ "MCWG", "LMV" ] } ], "detailsOfDrivingLicence": { "address": "C/304 PIMPLESHWAR CHS MAHADEV PALAV MARG CURREY RD MUMBAI MUMBAI,MUMBAI,MH 400013", "addressList": [ { "completeAddress": "C/304 PIMPLESHWAR CHS MAHADEV PALAV MARG CURREY RD MUMBAI MUMBAI,MUMBAI,MH 400013", "splitAddress": { "addressLine": "C/304 PIMPLESHWAR CHS MAHADEV PALAV MARG CURREY RD", "city": [ "MUMBAI" ], "country": [ "IN", "IND", "INDIA" ], "district": [ "MUMBAI" ], "pincode": "400013", "state": [ [ "MAHARASHTRA", "MH" ] ] }, "type": "permanent" }, { "completeAddress": "C/304 PIMPLESHWAR CHS MAHADEV PALAV MARG CURREY RD MUMBAI MUMBAI,MUMBAI,MH 400013", "splitAddress": { "addressLine": "C/304 PIMPLESHWAR CHS MAHADEV PALAV MARG CURREY RD", "city": [ "MUMBAI" ], "country": [ "IN", "IND", "INDIA" ], "district": [ "MUMBAI" ], "pincode": "400013", "state": [ [ "MAHARASHTRA", "MH" ] ] }, "type": "temporary" } ], "covDetails": [], "dateOfIssue": "08/01/2013", "dateOfLastTransaction": "", "fatherOrHusbandName": "DIVAKAR PANDEY", "lastTransactedAt": "", "name": "PUNEET PANDEY", "photo": "https://persist.signzy.tech/api/files/1180985344/download/ 06d677c4088049fabf618c6e54a786d03c1b2339bb3a4da186d21e2e268224a7.jpeg", "splitAddress": { "addressLine": "C/304 PIMPLESHWAR CHS MAHADEV PALAV MARG CURREY RD", "city": [ "MUMBAI" ], "country": [ "IN", "IND", "INDIA" ], "district": [ "MUMBAI" ], "pincode": "400013", "state": [ [ "MAHARASHTRA", "MH" ] ] }, "status": "ACTIVE" }, "dlNumber": "MH0120130001960", "dlValidity": { "hazardousValidTill": "", "hillValidTill": "", "nonTransport": { "from": "08/01/2013", "to": "07/01/2033" }, "transport": { "from": "", "to": "" } }, "dob": "05/10/1994" } } }

 

FAILED:

{ "status": "FAILED", "statusCode": 1, "statusDesc": "DL-verification failed", "data": { "message": { "error": { "message": "DL Number not found", "name": "Error", "status": 404, "statusCode": 404 } } } }

Invalid request:

{ "statusCode": -1, "status": "INVALID REQUEST", "statusDesc": "Invalid DOB", "data": {} }

Encrypted Sample Response Body

---

{ "ResponseData":"EE6V+m0GHnGryRZhcE0XRbqAayBqTPJSX/ lFalXrNsKSIoqaALdLAmrb0cfh3LDKKJlQnazu+rKp6OS9PqEuwpAFtbwtq2DPRy9INcqmiEBh1kzroDVD9 Vc9sN6y" }

Status Codes

Code	Significance	Description
0	SUCCESS	Successfully fetched driver license details
1	FAILED	DL-verification failed
-1	INVALID REQUEST	Invalid DOB