DL Fetch

Introduction

The Driving License fetch API provides a simple and secure way to verify the driving license details of individuals in India. With this API, you can easily integrate driving license verification functionality into your application or service. The API accepts a valid driving license number and date of birth as input, and returns the corresponding details of the driving license holder, including their name, father or husband's name, address, photograph, class of vehicle authorized to drive, validity period, and more. This API is useful for businesses or organizations that need to verify the driving license details of individuals for various purposes, such as hiring, background checks, and insurance.

API details

Endpoint

POST https://api.signzy.app/api/v3/dl_number/based_search

POST https://api-preproduction.signzy.app/api/v3/dl_number/based_search

Request Headers

Name	Value	Required	Description
Content-Type	application/json	Mandatory	The type of content that the request body contains.
Authorization	XXXXXXXXXXXXXXX	Mandatory	An authentication token to authorize the request. Reach out to the Signzy support team to get one created.

Request body parameters

Parameter	Data Type	Description	Required
number	String	The driving license number.	Mandatory
dob	String	The date of birth in the format "DD/MM/YYYY".	Mandatory

{
    "number": "<License Number>",
    "dob": "<DD/MM/YYYY"
}

Code samples

curl --location 'https://api-preproduction.signzy.app/api/v3/dl_number/based_search' \
--header 'Content-Type: application/json' \
--header 'Authorization: <your Auth Key>' \
--data '{
    "number": "your_license_number",
    "dob": "DD/MM/YYYY"
}'

Response body parameters

Parameter	Data Type	Description
result	Object	An object containing detailed information about the driving license.
result.dlNumber	String	The driving license number.
result.dob	String	Date of Birth of the license holder in the format "DD/MM/YYYY".
result.badgeDetails	Array of Objects	Contains a list of badges issued to the driving license including badge Issue Date and badge Number.
result.badgeDetails[].badgeIssueDate	String	The date when the badge is issued
result.badgeDetails[].badgeNo	String	The badge number.
result.badgeDetails[].classOfVehicle	Array of Strings	Class of vehicle for which the driving license is provided. Possible values: MCWG,LMV, HGMV, HPMV, MGV, HMV, HTV, MCWOG
result.dlValidity	Object	An object containing the validity details of different types of driving licenses.
result.dlValidity.nonTransport	Object	Validity information for non-transport
result.dlValidity.nonTransport.to	String	Contains Validity details for non-transport Vehicles.
result.dlValidity.nonTransport.from	String	Validity start date for non-transport.
result.dlValidity.hazardousValidTill	String	Validity details for hazardous goods carrying vehicles.
result.dlValidity.transport	Object	Contains Validity details for transport Vehicles.
result.dlValidity.transport.to	String	Validity end date for transport Vehicles.
result.dlValidity.transport.from	String	Validity start date for transport Vehicles.
result.dlValidity.hillValidTill	String	Validity details for hill driving.
result.detailsOfDrivingLicence	Object	An object containing additional details about the driving license.
result.detailsOfDrivingLicence.dateOfIssue	String	Date of issue of the driving license in the format "DD/MM/YYYY".
result.detailsOfDrivingLicence.dateOfLastTransaction	String	Date of the last transaction in the format "DD/MM/YYYY".
result.detailsOfDrivingLicence.status	String	Current status of the driving license. (e.g.:"ACTIVE") Possible values: Active, Inactive, Suspended, Revoked, Expired, Pending, Cancelled
result.detailsOfDrivingLicence.lastTransactedAt	String	Location where the last transaction related to the license took place.
result.detailsOfDrivingLicence.name	String	Name of the driving license holder
result.detailsOfDrivingLicence.fatherOrHusbandName	String	Name of the license holder's father or husband.
result.detailsOfDrivingLicence.addressList	Array of Objects	Contains address details associated with the driving license.
result.detailsOfDrivingLicence.addressList[].completeAddress	String	Complete address.
result.detailsOfDrivingLicence.addressList[].type	String	Type of address (permanent/temporary)
result.detailsOfDrivingLicence.addressList[].splitAddress	Object	contains the address details split into district, state, city, pincode and country.
result.detailsOfDrivingLicence.addressList[].splitAddress.district	Array of Strings	District information.
result.detailsOfDrivingLicence.addressList[].splitAddress.state	Array of Array of Strings	State information.
result.detailsOfDrivingLicence.addressList[].splitAddress.city	Array of Strings	City information.
result.detailsOfDrivingLicence.addressList[].splitAddress.pincode	String	Pincode information.
result.detailsOfDrivingLicence.addressList[].splitAddress.country	Array of Strings	Country information.
result.detailsOfDrivingLicence.addressList[].splitAddress.addressLine	String	Address line
result.detailsOfDrivingLicence.address	String	Primary address string
result.detailsOfDrivingLicence.photo	String	URL of the license holder's photo
result.detailsOfDrivingLicence.splitAddress	Object	Object containing primary split address components
result.detailsOfDrivingLicence.splitAddress.district	Array of Strings	Array of districts
result.detailsOfDrivingLicence.splitAddress.state	Array of Array of Strings	Array of states
result.detailsOfDrivingLicence.splitAddress.city	Array of Strings	Array of cities
result.detailsOfDrivingLicence.splitAddress.pincode	String	Pincode
result.detailsOfDrivingLicence.splitAddress.country	Array of Strings	Array of country codes
result.detailsOfDrivingLicence.splitAddress.addressLine	String	Address line
result.detailsOfDrivingLicence.covDetails	Array	Array containing Issue date of the specific Class of Vehicle.
result.detailsOfDrivingLicence.covDetails.covCategory	String	Class of vehicle category.
result.detailsOfDrivingLicence.covDetails.classOfVehicle	String	Class of vehicle
result.detailsOfDrivingLicence.covDetails.covIssuedate	String	Issue date of the specific Class of Vehicle.

This table includes all the nested objects and arrays within the JSON data you provided.

{
    "message": "Invalid authentication credentials"
}

Contact Us for Any Assistance

If you have any questions or need assistance, please reach out to our customer support team. You can contact us via email at [email protected]. We strive to provide prompt and reliable assistance, ensuring your queries are addressed effectively.

We value your feedback and are committed to making your experience smooth and enjoyable. Our team is dedicated to assisting you with any needs you may have. Thank you for choosing our services. We look forward to helping you!