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_searchPOST https://api-preproduction.signzy.app/api/v3/dl_number/based_searchRequest 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!