Driver's license

A driver's license is a document that is issued by a government authority that permits the holder to operate a motor vehicle.

The form_type parameter DRIVERS_LICENSE for the Upload PDF endpoint is required for this form type.

Learn more about how we process driver's licenses here.

📘

Configuration-driven output

All fields below are optionally captured, depending on your order form. To adjust fields captured, please speak with your Ocrolus Account Manager.

JSON Attribute

Data Type

Description

drivers_license-General:firstName

Text

First name of the individual who owns the drivers license

drivers_license-General:middleName

Text

Middle name of the individual who owns the drivers license

drivers_license-General:lastName

Text

Last name of the individual who owns the drivers license

drivers_license-General:suffix

Text

Default is_empty = TRUE, Suffix of the individual who owns the drivers license

drivers_license-General:addressLine1

Text

Address 1 of the individual who owns the drivers license

drivers_license-General:addressLine2

Text

Address 2 of the individual who owns the drivers license

drivers_license-General:city

Text

City in which the drivers license owner resides

drivers_license-General:state

Text

Formatted as a 2 character state code. State in which the drivers license owner resides

drivers_license-General:zip

Text

5 digit zip code in which the drivers license owner resides

drivers_license-General:countryName

UNITED STATES
OTHER

Country in which the issuing state resides

drivers_license-General:expirationDate

Date

Expiration date of the drivers license

drivers_license-General:idNumber

Text

Unique identification number of the drivers license

drivers_license-General:issuingState

Text

Formatted as a 2 character state code. State which issued the drivers license

drivers_license-General:issuingDate

Date

Date on which the license was issued and made effective

Sample document

The below Ocrolus sample PDF (input) matches the below sample JSON result (output).

Sample JSON response

{
    "status": 200,
    "response": {
        "pk": 32556521,
        "uuid": "e93704e6-d950-4eea-85dd-83d319fc1758",
        "forms": [
            {
                "pk": 31536788,
                "uuid": "ce700dda-3da9-4aab-88a2-f23a3850be55",
                "form_type": "DRIVERS_LICENSE",
                "form_config_pk": 21147,
                "tables": [],
                "raw_fields": {
                    "drivers_license-General:dob": {
                        "value": "01/06/1958",
                        "is_empty": false,
                        "alias_used": null,
                        "source_filename": "Alexander Hamilton-DRIVING-LICENSE.pdf"
                    },
                    "drivers_license-General:zip": {
                        "value": "99999-1234",
                        "is_empty": false,
                        "alias_used": null,
                        "source_filename": "Alexander Hamilton-DRIVING-LICENSE.pdf"
                    },
                    "drivers_license-General:city": {
                        "value": "YOUR CITY",
                        "is_empty": false,
                        "alias_used": null,
                        "source_filename": "Alexander Hamilton-DRIVING-LICENSE.pdf"
                    },
                    "drivers_license-General:state": {
                        "value": "WA",
                        "is_empty": false,
                        "alias_used": null,
                        "source_filename": "Alexander Hamilton-DRIVING-LICENSE.pdf"
                    },
                    "drivers_license-General:suffix": {
                        "value": "",
                        "is_empty": true,
                        "alias_used": null,
                        "source_filename": "Alexander Hamilton-DRIVING-LICENSE.pdf"
                    },
                    "drivers_license-General:idNumber": {
                        "value": "WDLABCD456DG",
                        "is_empty": false,
                        "alias_used": null,
                        "source_filename": "Alexander Hamilton-DRIVING-LICENSE.pdf"
                    },
                    "drivers_license-General:lastName": {
                        "value": "SAMPLE",
                        "is_empty": false,
                        "alias_used": null,
                        "source_filename": "Alexander Hamilton-DRIVING-LICENSE.pdf"
                    },
                    "drivers_license-General:firstName": {
                        "value": "ALEXANDER",
                        "is_empty": false,
                        "alias_used": null,
                        "source_filename": "Alexander Hamilton-DRIVING-LICENSE.pdf"
                    },
                    "drivers_license-General:issueDate": {
                        "value": "01/06/2015",
                        "is_empty": false,
                        "alias_used": null,
                        "source_filename": "Alexander Hamilton-DRIVING-LICENSE.pdf"
                    },
                    "drivers_license-General:middleName": {
                        "value": "HAMILTON",
                        "is_empty": false,
                        "alias_used": null,
                        "source_filename": "Alexander Hamilton-DRIVING-LICENSE.pdf"
                    },
                    "drivers_license-General:countryName": {
                        "value": "UNITED STATES",
                        "is_empty": false,
                        "alias_used": null,
                        "source_filename": "Alexander Hamilton-DRIVING-LICENSE.pdf"
                    },
                    "drivers_license-General:addressLine1": {
                        "value": "123 STREET ADDRESS",
                        "is_empty": false,
                        "alias_used": null,
                        "source_filename": "Alexander Hamilton-DRIVING-LICENSE.pdf"
                    },
                    "drivers_license-General:addressLine2": {
                        "value": "",
                        "is_empty": true,
                        "alias_used": null,
                        "source_filename": "Alexander Hamilton-DRIVING-LICENSE.pdf"
                    },
                    "drivers_license-General:issuingState": {
                        "value": "WA",
                        "is_empty": false,
                        "alias_used": null,
                        "source_filename": "Alexander Hamilton-DRIVING-LICENSE.pdf"
                    },
                    "drivers_license-General:expirationDate": {
                        "value": "08/12/2020",
                        "is_empty": false,
                        "alias_used": null,
                        "source_filename": "Alexander Hamilton-DRIVING-LICENSE.pdf"
                    }
                }
            }
        ]
    },
    "message": "OK"
}

Did this page help you?