DL Extraction

8 min

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