DL Extraction
Overview
This API allows users to extract relevant data from Indian Driving Licenses. The API takes an image of the Driving License as input and returns the extracted data in JSON format.
The API is designed to extract information such as the driver's name, license number, date of birth, address, blood group, and other relevant information. This data can be used for various purposes, such as verification, record keeping, and analysis.
Endpoints | Environment |
|---|---|
https://api-preproduction.signzy.app/api/v3/driving-license/extractions | Preproduction |
https://api.signzy.app/api/v3/driving-license/extractions | Production |
curl --location 'https://api.signzy.app/api/v3/voter-id/extractions' \
--header 'Content-Type: application/json' \
--header 'Authorization: <AuthKey>' \
--data '{
"files": [
"https://files-staging.signzy.tech/api/files/2058624/download/19eff490daf14cfea89dc3000cd8294c2331c2721cae448e811fbf929c21582f.jpg"
]
}'Headers
Header Name | Required | Description |
|---|---|---|
Content-Type | Yes | The content type of the request body. In this case, it is JSON. |
Authorization | Yes | API authorization key. |
Input Parameters
Parameter | Type | Description |
|---|---|---|
files | array | An array of URLs of the images to be processed |
Output Parameters
Field Name | Description | Data Type |
|---|---|---|
files | An array of file URLs extracted by the API | Array |
id | A unique ID for the document | Integer |
result | A dictionary of extracted fields from the input document | Dictionary |
result.dlType | An array of driving license types | Array |
result.issueDate | The date of issue of the driving license | String |
result.expiryDate | The date of expiry of the driving license | String |
result.dob | The date of birth of the license holder | String |
result.name | The name of the license holder | String |
result.number | The license number | String |
result.state | The state where the license was issued | String |
result.address | The full address of the license holder | String |
result.gaurdianName | The name of the guardian of the license holder | String |
result.splitAddress.district | The district in which the address is located | Array |
result.splitAddress.state | An array containing the state name and state code | Array |
result.splitAddress.city | The city in which the address is located | Array |
result.splitAddress.pincode | The pincode of the address | String |
result.splitAddress.country | An array containing the country code and name | Array |
result.splitAddress.addressLine | The street address of the license holder | String |
result.summary.number | The license number | String |
result.summary.name | The name of the license holder | String |
result.summary.dob | The date of birth of the license holder | String |
result.summary.address | The full address of the license holder | String |
result.summary.splitAddress.district | The district in which the address is located | Array |
result.summary.splitAddress.state | An array containing the state name and state code | Array |
result.summary.splitAddress.city | The city in which the address is located | Array |
result.summary.splitAddress.pincode | The pincode of the address | String |
result.summary.splitAddress.country | An array containing the country code and name | Array |
result.summary.splitAddress.addressLine | The street address of the license holder | String |
result.summary.gender | The gender of the license holder | String |
result.summary.guardianName | The name of the guardian of the license holder | String |
result.summary.issueDate | The date of issue of the driving license | String |
result.summary.expiryDate | The date of expiry of the driving license | String |
Sample Response:
{
"files": [
"https://files-staging.signzy.tech/api/files/2058624/download/19eff490daf14cfea89dc3000cd8294c2331c2721cae448e811fbf929c21582f.jpg"
],
"id": 2352,
"result": {
"dlType": [
"LMV-NT",
"M.CYL"
],
"issueDate": "29/07/2009",
"expiryDate": "28/07/2029",
"dob": "11/04/1990",
"guardianName": "SHRI RAJKUMAR CHARAYA",
"name": "VXXX CXXXXXX",
"number": "DL-0xxxxx0xxxx01",
"state": "Delhi",
"address": "A-22 NXXW GXXXXX CXXXXX R.P.BAGH DXXXX 110009",
"gaurdianName": "SHRI RAJKUMAR CHARAYA",
"splitAddress": {
"district": [
"NORTH WEST DELHI"
],
"state": [
[
"DELHI",
"DL"
]
],
"city": [
"DELHI"
],
"pincode": "110009",
"country": [
"IN",
"IND",
"INDIA"
],
"addressLine": "A-22 NXXW GXXXXX CXXXXX R.P.BAGH"
},
"summary": {
"number": "DL-0xxxxx0xxxx01",
"name": "VXXX CXXXXXX",
"dob": "11/04/1990",
"address": "A-22 NXXW GXXXXX CXXXXX R.P.BAGH DXXXX 110009",
"splitAddress": {
"district": [
"NORTH WEST DELHI"
],
"state": [
[
"DELHI",
"DL"
]
],
"city": [
"DELHI"
],
"pincode": "110009",
"country": [
"IN",
"IND",
"INDIA"
],
"addressLine": "A-22 NXXW GXXXXX CXXXXX R.P.BAGH"
},
"gender": "",
"guardianName": "SHRI RAJKUMAR CHARAYA",
"issueDate": "29/07/2009",
"expiryDate": "28/07/2029"
}
}
}
Response Times
95% ile | 99 % ile | 90 % ile |
|---|---|---|
| | |
Status Codes
Status Code | Description |
|---|---|
200 | OK |
400 | Bad Request |
409 | Upstream Down |
422 | Unprocessable Entity |