US 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 AttributeData TypeDescription
drivers_license-General:firstNameTextFirst name of the individual who owns the drivers license
drivers_license-General:middleNameTextMiddle name of the individual who owns the drivers license
drivers_license-General:lastNameTextLast name of the individual who owns the drivers license
drivers_license-General:suffixTextDefault is_empty = TRUE, Suffix of the individual who owns the drivers license
drivers_license-General:addressLine1TextAddress 1 of the individual who owns the drivers license
drivers_license-General:addressLine2TextAddress 2 of the individual who owns the drivers license
drivers_license-General:cityTextCity in which the drivers license owner resides
drivers_license-General:stateTextFormatted as a 2 character state code. State in which the drivers license owner resides
drivers_license-General:zipText5 digit zip code in which the drivers license owner resides
drivers_license-General:countryNameUNITED STATESOTHERCountry in which the issuing state resides
drivers_license-General:expirationDateDateExpiration date of the drivers license
drivers_license-General:idNumberTextUnique identification number of the drivers license
drivers_license-General:issuingStateTextFormatted as a 2 character state code. State which issued the drivers license
drivers_license-General:issuingDateDateDate 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"
}