US DL Extraction

7 min

Introduction

The driver's license extraction API utilizes OCR technology to extract information from scanned or photographed driver's licenses. It analyzes the image, recognizes the text, and retrieves relevant data such as name, date of birth, address, and license number. The API returns the extracted data in a structured format, enabling automated processes like identity verification and form population.

API Input Guidelines

You need to pass the URL of the document you need to scan in the input. To do this, you can use Signzy's File exchanger APIs and create a link.

Sample Curl

curl --location 'https://api-preproduction.signzy.app/api/v3/us/extraction/drivers-license' \
--header 'Authorization: <Auth Token>' \
--header 'Content-type: application/json' \
--data-raw '{   
    "url": "https://preproduction-persist.signzy.tech/api/files/38025957/download/13be2896ece646e3970bfad1b18b8ca8c21392d436e84c06a96ffe8ce03edfb0.jpg"
}'

Input Parameters

Parameter	Type	REQUIRED/OPTIONAL
url	string	The URL of the driver's license whose information needs to be extracted

Sample Response

[
    {
        "type": "Portrait",
        "value": "",
        "confidence": 0.97265625
    },
    {
        "type": "Address",
        "value": "2796 NICOLE CIR\nAURORA, IL 60502",
        "confidence": 0.9514525532722473
    },
    {
        "type": "Date Of Birth",
        "value": "02/21/1990",
        "confidence": 0.9913428425788879
    },
    {
        "type": "Document Id",
        "value": "P620-7949-0052",
        "confidence": 0.9997496008872986
    },
    {
        "type": "Expiration Date",
        "value": "02/21/2027",
        "confidence": 0.9985931515693665
    },
    {
        "type": "Family Name",
        "value": "STACK",
        "confidence": 0.989298939704895
    },
    {
        "type": "Given Names",
        "value": "RYAN",
        "confidence": 0.9891515374183655
    },
    {
        "type": "Issue Date",
        "value": "03/15/2022",
        "confidence": 0.9996445775032043
    }
]

Response Parameters

Parameter Name	Description
type	It can be the following types - 1. MRZ Code 2. Portrait 3. Date of Birth 4. Document ID 5. Expiration Date 6. Family Name 7. Given Name 8. Issue Date
value	The value corresponding to Name, Address, DOB, etc.
confidence	The numerical value between 0 and 1, which indicates the level of certainty.

Status Codes

CODE	MESSAGE
200	Success
401	Kindly check authorization
422	File url is not valid
500	Internal error at Signzy, contact Signzy support

Getting help

Please feel free to contact us if you have any questions, require clarification, or have ideas for how to make the documents or any of our services better.

You can reach out to us at [email protected].