Home

Verifies an ID document barcode. Requires a barcode string in base64-encoded text.

Log in to see full request history
Body Params
public_data
object
required

May not contain personally identifiable information (PII). A public_data object is required even if it is empty, for example, public_data: {}.

private_data
object
required

May contain personally identifiable information (PII).

Headers
string
required
Defaults to <calculated_signature>

Encrypted Request Body

string
required
Defaults to <customer_id>

Your provided Customer ID.

Responses

Response body
object
public_data
object
required
boolean

Boolean that specifies if the ID check was successful or not

string

Version of the API.

string

The requested endpoint.

private_data
object
required
string

Processing result status code. See ID Verification processResult Definitions.

DocumentProcessOK DocumentBadRead DocumentBadDevice DocumentUnknown Document1DDocument ErrorBadConfiguration UnexpectedError

string
deprecated

Processing result diagnostic code. Values are Y, U, B, IUX, F, 1, UEE.

Y U B IUX F 1 UEE

string

Contains the first name.

string

Contains the middle name.

string

Contains the last name with suffix if present.

string

Contains line one of the residence address.

string

Contains line two of the residence address.

string

Contains the city of residence.

string

Contains the jurisdiction of residence.

string

Contains the postal code (zip code) of residence.

string

Contains the date of birth in MM/DD/YYYY format. When a partial birth date is encoded on the document, the fields that are unknown will be filled in with ? characters. For example: 01/12/???? will be returned for a document that does not encode the birth date year.

number

Contains the age based on the date of birth and the current system date. The age will be 1 if the age is unknown. The age will be 1 if either no date of birth or a partial date of birth is encoded.

string

Contains the height in centimeters as specified on the ID.

string

Contains the height in feet and inches as specified on the ID, for example, 5’2”.

string

Contains the weight in kilograms as specified on the ID.

string

Contains the weight in pounds as specified on the ID.

string

Contains the eye color. If the jurisdiction code for eye color is known, the color’s name is returned, for example, brown, blue, hazel. If the code is not recognized, the code that is encoded on the document is returned.

string

Contains the hair color. If the jurisdiction code for hair color is known, the color’s name is returned, for example, brown, black, blonde. If the code is not recognized, the code that is encoded on the document is returned.

string

Contains the gender. Either Male or Female.

string

This field is intentionally blank.

string

Contains the media type of the processed document. Examples include MAG and 2D.

number

Contains a unique ID to identify the document format. All jurisdiction document formats are assigned a unique ID by Intellicheck.

boolean

True if the document is an Intellicheck test card; false otherwise. Intellicheck can provide test cards that produce different responses for system testing and demonstration.

string

Contains the raw driver license or ID (DL/ID) value. This will not contain any formatting characters, such as spaces and hyphens. It will contain only the alphanumeric characters that make up the DL/ID.

string

Contains the formatted driver license or ID (DL/ID) value. This will contain the formatting characters, such as spaces and hyphens, as it appears on the printed document.

string

Contains the restriction codes encoded on the document.

string

Contains the endorsement codes encoded on the document.

string

Contains the driver class codes encoded on the document.

string

Contains Yes or No indicating if the document owner is an organ donor.

string

Contains the expiration date of the processed document in MM/DD/YYYY format or the word NEVER for documents that do not expire. When a partial expiration date is encoded on the document, the fields that are unknown will be filled in with ? characters. For example, 01/12/???? will be returned for a document that does not encode the expiration year.

string

Contains the expiration status of the document. Values are Yes, No, or Unknown.

Yes No Unknown

string

Contains the date of issuance of the document in MM/DD/YYYY format.

string

Contains the full name of the issuing jurisdiction, for example, New York.

string

Contains the name of the issuing jurisdiction as an abbreviation. This value will always be two letters, for example, NY.

string

Contains the document duplication status. Values are Yes, No, or empty. An empty value means the duplicate status is unknown.

Yes No {empty}

string

Contains the date the duplicate document was issued in MM/DD/YYYY format.

string

Contains the type of document (if available) from the barcode, for example, Driver's License, Learner's Permit, Operator License, and so on. Values vary by issuing jurisdiction. An empty value means the type is not identifiable.

string

Contains the document category acronym from the barcode. The value is typically one of the following: DL (driver license), HC (health card), ID (identification card), MIL (military identification). Rarely, certain other values are possible: WPN (weapon), HCP (handicap), WV (water vehicle), EMP (employee), OID (other). An empty value means the category is not identifiable.

DL HC ID MIL WPN HCP WV EMP OID {empty}

string

Contains the document REAL ID status. Values are Yes, No, or empty. Yes means the document was issued in compliance with United States Department of Homeland Security (DHS) requirements for the REAL ID Act passed by Congress in 2005. No means it was not. An empty value means the document did not have enough information to determine a result.

Yes No {empty}

string

Contains a status of whether the address state compared to the document issuer are mismatched. Values are Yes, No, or Unknown. Yes means the state and issuer do not match. No means the state and issuer match. Unknown means the match status is not known.

No Yes Unknown

string

Contains a transaction ID.

transaction_location
object

Transaction location details. This object can be used for tracking and reporting requirements. This is the response object for the optional transaction_location request object. This object is not returned unless requested.

user_defined
object

A user-defined JSON object. This is the response object for the optional user_defined request object. This property is not returned unless requested.

Language