Use the Document Verification GET API to obtain verification records from previous passport and driver's license inquiries.
The Document Verification GET API is a REST HTTPS endpoint that uses OAuth 2.0 for authentication. To view the swagger file, go to Identity Proofing Service.
Method: GET
Header Authorization: Bearer token
Header Content-Type: application/json
Body: Refer to the Get Orders request parameters.
Document Verification data comes from a third party service. This document provides the data fields that this service uses when evaluating the original data and providing a score.
sidebar. Core checks
|
Name |
Impact |
Key |
Description |
|
Overall Session Status |
High |
overall.status |
Overall session score reflects the lowest high-level score, such as ID Validation, Face Recognition, Liveness, or Government Validation. |
|
Face Recognition Overall Score |
High |
faceRecognition.overall |
Evaluates if the selfie matches the face on the ID document. |
|
Liveness Overall |
High |
liveness.overall |
Evaluates if the selfie is a picture of a real person and not a picture of a picture. |
|
ID Validation Overall |
High |
idValidation.overall |
A composite evaluation of many different ID checks to determine if the document appears fraudulent. |
|
Document Classification |
High |
documentClassification |
Confirms that the document type is supported and that it can be fully authenticated. |
|
Screen ID Liveness |
High |
screenldLiveness |
Confirms that the document was captured from a screen, meaning a physical document was not used. |
|
Paper ID Liveness |
High |
paperldLiveness |
Determines if the document was captured from a printed paper. In the case of passports, this check uses a model to detect if the passports are correctly displaying passport paper. |
|
Barcode PDF417 Check |
High |
fakeCheck |
Validates information decoded from the pdf417 barcode on the back side of US driver's licenses or other IDs. |
sidebar. ID Validation checks
|
Name |
Impact |
Key |
Description |
|
ID Alteration Check |
Low |
idAlterationCheck |
Determines if there are any foreign objects on the document. |
|
Alignment |
Very Low |
alignment |
The picture is badly aligned and the correcting algorithm could not correct it for processing. Note: If alignment fails, Document Classification also fails and additional ID tests do not perform. |
|
Id Already Used Check |
Very Low |
idAlreadyUsedCheckResult |
Determines if the document was used in another session where the face belonged to a different person. |
|
Readability Check |
Very Low |
readabilityCheck |
Determines the correlation between the results of different Optical Character Recognition (OCR) algorithms. |
|
Balanced Light Front/Back |
Very Low |
balancedLightFront/balancedLightBack |
Determines if there are proper lighting conditions to take the photo of the document. |
|
Sharpness Front/Back |
Very Low |
sharpnessFront/sharpnessBack |
Determines if the photo of the document is sharp enough. |
|
Real ID |
Very Low |
realld |
A US-only check for the upgraded version of a driver's license that has a star in the right corner. |
|
Punched Holes |
Very Low |
punchedHoles |
Detects if punched holes are present, signaling the document's invalidity or expiration. |
|
Fake ID check |
Medium |
fakeldCheck |
Searches for discrepancies in the document layout and other signs of fraud. |
|
Tamper Check |
High |
tamperCheck |
Determines if the front of the document was physically tampered with. |
|
Screen ID Liveness |
High |
screenldLiveness |
Determines if the document was captured from a screen. |
|
Paper ID Liveness |
High |
paperldLiveness |
Determines if the document was captured from a printed paper. |
|
Document Classification |
High |
documentClassification |
Confirms the document type is supported and can be authenticated. |
|
Visible Photo Features |
Low |
photoCharacteristics |
Verifies the visible photo characteristics. |
|
Issue Date Validity |
Low |
issueDateValidity |
Confirms the date the document was issued is valid. |
|
Document Expired |
High |
documentExpired |
Confirms the document has not expired. |
|
Document Series Expired |
High |
documentSeriesExpired |
Confirms that an old, invalid version of the document is not being used. |
|
Birth/Expiration Date Validity |
Low |
birthDateValidity/expirationDateValidity |
Confirms that the dates are valid. |
|
Issuing State Validity |
Low |
issuingStateValidity |
Confirms that the state where the document was issued is valid. |
|
QR Scan |
Medium |
qrScan |
Confirms the check digit extracted from the QR code is the same as the one from the Machine-Readable Zone (MRZ). |
|
Document Number Check Digit |
Low |
documentNumberCheckDigit |
Confirms the document number check digit is correct. |
|
Birth/Expiration Date Check Digit |
Low |
birthDateCheckDigit/expirationDateCheckDigit |
Confirms the control number from the MRZ for the respective OCR fields. |
|
Composite Check Digit |
Low |
compositeCheckDigit |
Validates the visible composite check digit by comparing it with a calculated one. |
|
Illiteracy Check |
Very Low |
illiteracyCheck |
Determines if the owner of the ID is illiterate. |
|
2D Barcode Content/Detected |
Very Low |
2DBarcodeContent/barcode2DDetected |
Checks the content and presence of a barcode on the back of the ID (US and CAN only). |
|
Underage Check |
Low |
underageCheck |
Determines if the ID belongs to a person under 18. |
|
Renapo Check |
Medium |
renapoCheck |
Third-party Clave Única de Registro de Población (CURP) validation (MEX only). |
|
Crosschecks |
Medium |
birthDateCrosscheck, expirationDateCrosscheck, and others |
Compares various fields (birth date, full name, document number) between the MRZ and human-readable zones. |
|
Age Crosscheck |
Medium |
ageCrosscheck |
Confirms the estimated age from the selfie is aligned with the birth date. |
|
Mrz Line Format Check |
Medium |
mrzLineFormatCheck |
Confirms the format and character length of the MRZ line is valid. |
|
Mrz Parsable Check |
Medium |
mrzParsableCheck |
Determines if the MRZ ID is parsable. |
sidebar. Face Recognition checks
|
Name |
Impact |
Key |
Description |
|
Mask check |
Very Low |
maskCheck |
Detects if the face contains a mask. |
|
Face Brightness |
Very Low |
faceBrightness |
Detects if there is enough light on the face for recognition. |
|
Exact Face Match |
High |
exactFaceMatch |
Detects if the face on the ID matches the selfie exactly. |
|
Face Recognition |
High |
faceRecognition |
Detects if the selfie matches the face on the ID document. |
|
Lens check |
Very Low |
lensesCheck |
Detects if someone is wearing glasses in the selfie. |
|
Has eyes closed |
Very Low |
hasClosedEyes |
Detects if eyes are closed. |
|
Has head cover |
Very Low |
hasHeadCover |
Detects if hats or hoods are present. |
sidebar. Liveness checks
|
Name |
Impact |
Key |
Description |
|
Liveness |
High |
liveness |
Detects if the selfie is of a real person and not a picture of a picture. |
|
Physical Attack |
Medium |
physcialAttack |
Detects if the face is of printed photos or 3D masks. |
|
Face Evasion Attack |
Medium |
evasionAttack |
Detects if someone is making extreme faces to conceal their identity. |
|
Digital Attack |
Medium |
digitalAttack |
Detects if the face appears to be digitally altered. |
sidebar. Government Validation Checks (AAMVA)
|
Name |
Impact |
Key |
Description |
|
Government Validation Overall |
High |
governmentValidation.overall |
Overall government validation status, factoring in all government validation checks. |
|
Government Validation Issue Date |
Medium |
governmentValidation.ocrValidation -> issueDate |
Matches issue date on ID to issue date at the Department of Motor Vehicles (DMV). |
|
Government Validation First Name |
Medium |
governmentValidation.ocrValidation -> firstName |
Matches first name on ID to first name at DMV. |
|
Government Validation Last Name |
Medium |
governmentValidation.ocrValidation -> paternalLastName |
Matches last name on ID to last name at DMV. |
|
Government Validation Birth Date |
Medium |
governmentValidation.ocrValidation -> birthDate |
Matches birth date on ID to birth date at DMV. |
|
Government Validation Expiration Date |
Medium |
governmentValidation.ocrValidation -> expiration Date |
Matches expiration date on ID to expiration date at DMV. |
sidebar. California Government Validation Checks (DMV Face Match)
|
Name |
Impact |
Key |
Description |
|
DMV Face Match |
High |
governmentValidation.governmentValidationResponse.matched |
Determines if a user’s selfie or face on ID matches the face on file at the California (CA) DMV. DMV Matching will also confirm these OCR fields: paternalLastName (first 3-characters), birthdate, and documentNumber. |
sidebar. Georgia Government Validation Checks (DMV Face Match)
|
Name |
Impact |
Key |
Description |
|
DMV Face Match |
High |
governmentValidation.governmentValidationResponse.faceMatched |
Determines if a user’s selfie or face on ID matches the Face on file at the Georgia (GA) DMV (Department of Driver Services, or DDS). DMV Matching will also confirm these OCR fields: firstName, paternalLastName (first 3-characters), birthdate, and documentNumber. |
sidebar. Behavioral Risk (Device)
|
Name |
Impact |
Key |
Description |
|
Behavioral Risk Overall |
High |
behavioralRisk.overall |
Asserts if the device broadcasted normal device orientation and behavior during camera capture. |
|
Behavioral Risk Front ID Capture |
Medium |
behavioralRisk.frontIdStatsAnalysisStatus |
Confirms normal device behavior during front ID capture. |
|
Behavioral Risk Back ID Capture |
Medium |
behavioralRisk.backIdStatsAnalysisStatus |
Confirms normal device behavior during back ID capture. |
|
Behavioral Risk Selfie Capture |
Medium |
behavioralRisk.selfieStatsAnalysisStatus |
Confirms normal device behavior during selfie capture. |
|
Behavioral Risk Motion |
Medium |
behavioralRisk.motionStatus |
Confirms that the device displayed normal motion behavior. |
sidebar. Antifraud checks
|
Name |
Impact |
Key |
Description |
|
Antifraud Result |
High |
antifraud.overall |
Antifraud checks work by comparing each new onboarding session against all previous sessions for the same client to identify anomalies or reused information. These checks assess multiple dimensions of data to strengthen fraud detection. Personal information such as names, document numbers, and other data are used to uncover suspicious reuse. Biometric data is analyzed through face comparisons between selfies and ID photos across different sessions to detect duplicates or mismatches. In addition, device and network signals like IP addresses and device fingerprints are monitored to flag multiple attempts originating from the same sources. Together, these layers create a comprehensive safeguard against fraudulent activity. The overall antifraud result is an aggregation of these checks. |
sidebar. Deep Fake and Injection Detection (DeepSight)
|
Name |
Impact |
Key |
Description |
|
DeepSight Overall |
High |
deepsight.overall |
Determines whether images used during verification were digitally altered by Al or other methods and subsequently injected into the transaction. |
|
DeepSight Physical Attack |
Medium |
deepsight.multimodalIntelligence.physicalAttack |
Detects if the face is of printed photos or 3D masks in a single frame or multiple frames. |
|
DeepSight Evasion Attack |
Medium |
deepsight.multimodalIntelligence.evasionAttack |
Detects if someone is making extreme faces to conceal their identity in a single frame or multiple frames. |
|
DeepSight Spoof Detection Method |
Medium |
deepsight.multimodalIntelligence.spoofDetectionMethod |
Indicates which detection mode or methodology was used when analyzing a session with DeepSight enabled:
|
|
DeepSight Multi-Modal Overall |
Medium |
deepsight.multimodalIntelligence.faceOverall |
Represents the aggregated score and status for all face-related spoof detection checks within the DeepSight Multi-Modal Intelligence component. |
|
DeepSight Al Genererated Document |
Medium |
deepsight.multimodalIntelligence.aiGeneratedDocument |
Asserts if the document submitted appeared to be Al-generated or synthetic. |
|
DeepSight Document Overeall |
Medium |
deepsight.multimodalIntelligence.documentOverall |
Represents the aggregated score and status for all document-related checks within the DeepSight document analysis capabilities. |
|
DeepSight MultiModal Intelligence Overall |
Medium |
deepsight.multimodalIntelligence.overall |
Represents the aggregated score and status for all Multi-Modal Intelligence checks within DeepSight. |
|
DeepSight Device Trust |
Medium |
deepsight.deviceTrust.overall |
Asserts if the device is tampered, emulated, or a virtual device to ensure that the session is happening on a legitimate, secure device. It analyzes device signals to identify fraudulent attempts, including:
|
|
DeepSight Camera Trust |
Medium |
deepsight.cameraTrust.overall |
Determines whether camera integrity or authenticity issues would hinder the verification process. |
sidebar. OCR data elements associated with Identity Verification documents
|
Key |
Label |
Description |
|
name.fullName |
Full Name |
Full name as printed on the document's visible text (VIZ). Might differ from a Machine-Readable Zone (MRZ) or barcode variants. |
|
name.machineReadableFullName |
Full Name (MRZ/Barcode) |
Full name as parsed from machine-readable data sources (MRZ or barcode). Useful for crosschecks. |
|
name.firstName |
First Name |
First name from the VIZ. For some countries this is equivalent to givenName. |
|
name.givenName |
Given Name |
Given names as printed. Can contain multiple tokens when culture uses multiple given names. |
|
name.middleName |
Middle Name |
Middle name if present on the VIZ. Optional property. |
|
name.nameSuffix |
Name Suffix |
Suffix such as Jr., Sr., III when present on the VIZ. Optional property. |
|
name.paternalLastName |
Paternal Last Name |
Primary family name used in paternal naming conventions, such as on Mexico/Latin America (MX/LatAm) IDs. |
|
name.maternalLastName |
Maternal Last Name |
Secondary family name used in maternal naming conventions, such as on MX/LatAm IDs. Optional property. |
|
name.givenNameMrz |
Given Name (MRZ) |
Given names as parsed from MRZ. Used for document crosschecks. |
|
name.lastNameMrZ |
Last Name (MRZ) |
Family names parsed from MRZ. Used for crosschecks with VIZ. |
|
address |
Address (Raw) |
Unparsed address string as read from the document. |
|
addressFields.street |
Street |
Street line parsed from the VIZ or barcode/MRZ where available. |
|
addressFields.colony |
Colony |
Subdivision used in certain countries (for example, MX). Optional property. |
|
addressFields.postalCode |
Postal Code |
Postal or ZIP code parsed from the document. |
|
addressFields.city |
City |
City or locality parsed from the document. |
|
addressFields.state |
State |
State or province parsed from the document. It will be an abbreviation or name depending on the source. |
|
checkedAddress |
Checked Address |
Normalized address produced by geocoding for consistency and downstream checks. |
|
checkedAddressBean.street |
Checked Street |
Normalized street line after geocoding. |
|
checkedAddressBean.city |
Checked City |
Normalized city after geocoding. |
|
checkedAddressBean.state |
Checked State |
Normalized state or province. Often accompanied by |
|
checkedAddressBean.stateName |
Checked State Name |
Full state/province name from normalization where the state code is abbreviated. |
|
checkedAddressBean.postalCode |
Checked Postal Code |
Normalized postal code. |
|
checkedAddressBean.addressCountryCode |
Country Code |
ISO country code for the normalized address. For example, USA, MEX, CAN. |
|
checkedAddressBean.latitude |
Latitude |
Latitude returned by address normalization/geocoding. |
|
checkedAddressBean.longitude |
Longitude |
Longitude returned by address normalization/geocoding. |
|
birthDate |
Birth Date |
Date of birth. Formats can be epoch milliseconds or a string depending on source. Often present in VIZ and barcode/MRZ. |
|
gender |
Gender |
Gender marker from the document, for example, M/F/X. Can be single-letter. |
|
documentNumber |
Document Number |
Primary identifier of the ID, such as Driver's License (DL) or passport number. Format can vary by region and source (VIZ vs barcode). |
|
refNumber |
Reference Number |
Secondary document reference often shown on drivers' licenses and some IDs. |
|
issuingCountry |
Issuing Country |
Country that issued the document. Usually a 3-letter code in barcode MRZ or the name on the VIZ. |
|
issueDate |
Issue Date (Year) |
Year or date the document was issued, as printed or parsed. Some sources provide only the year. |
|
issuedAt |
Issued At |
Full timestamp of issuance, often epoch milliseconds. Useful where |
|
expirationDate |
Expiration Date (Year) |
Year or date the document expires, as printed or parsed. |
|
expireAt |
Expire At |
Full expiration timestamp, often epoch milliseconds, when available from barcode/MRZ. |
|
birthPlace |
Birth Place |
Place of birth when present on the VIZ (country/state/city varies by document). |
|
nationality |
Nationality |
Nationality as printed on the VIZ. |
|
nationalityMrz |
Nationality (MRZ) |
Nationality code from MRZ, used for crosschecks. |
|
nationalityAlpha3 |
Nationality (Alpha-3) |
Three-letter nationality code when provided. |
|
typeOfld |
Type of ID |
High-level document type, for example |
|
documentFrontSubtype |
Document Front Subtype |
Subtype for the front side, such as NATIONAL_PASSPORT or VOTER_IDENTIFICATION_CARD. |
|
documentBackSubtype |
Document Back Subtype |
Subtype for the back side when applicable. |
|
classes |
DL Class / Category |
License class or vehicle category as printed on the document. For example, E. |
|
mentions |
Endorsements |
Additional endorsements or mentions. For example, NONE. |
|
restrictions |
Restrictions |
License restrictions. For example, A for specific restrictions. |
|
height |
Height |
Height as encoded. Units might be inches, centimeters, or alphanumeric like 066 IN. |
|
cic |
CIC |
Country-specific identifier for a Civil Identity Card (CIC), such as MX voter card. Appears on some LatAm IDs. |
|
claveDeElector |
Clave de Elector |
MX voter identification code when present. |
|
numeroEmisionCredencial |
Número de Emisión |
MX credential emission number for voter IDs. |
|
curp |
CURP |
Clave Única de Registro de Población (CURP). MX Unique Population Registry Code extracted from the VIZ or barcode when present. |
|
mrz1 |
MRZ Line 1 |
First line of MRZ text (as read by OCR). Might be empty if not present or unreadable. |
|
mrz2 |
MRZ Line 2 |
Second MRZ line. |
|
mrz3 |
MRZ Line 3 |
Third MRZ line for documents that have three lines (e.g., ID cards). |
|
documentNumberCheckDigit |
Document Number Check Digit |
MRZ check digit for the document number when available. |
|
dateOfBirthCheckDigit |
Check Digit DOB |
MRZ check digit for date of birth when available. |
|
expirationDateCheckDigit |
Expiration Check Digit |
MRZ check digit for expiration date when available. |
|
barcodeRawData |
Barcode Raw Data |
Raw text decoded from barcode. For example, PDF417 on US DLs. Useful for debugging and reconciliation. |
|
frontVizOcrData[ ] |
Front VIZ OCR (KV) |
Array of key/value pairs from front-side visible text areas. Keys can include name, address, dates, and more. |
|
backVizOcrData[ ] |
Back VIZ OCR (KV) |
Array of key/value pairs from back-side visible text, where applicable. |
|
barcodeOcrData[ ] |
Barcode OCR (KV) |
Array of key/value pairs parsed from barcode data, already split into fields. For example, address components. |
|
ocrDataConfidence.* |
Field Confidence |
Per-field confidence scores (0-1) for extracted items. For example, |
|
notExtracted |
Not Extracted Count |
Number of expected elements not extracted. For example, |
|
notExtractedDetails[ ] |
Not Extracted Details |
List of missing elements, such as |
These examples show potential responses when using the GET API to verify passports or drivers' licenses.
sidebar. Passport response example
{
"authenticationId": "d6067216-6e07-474c-8794-fde90e856c47",
"ocrData": {
"birthDate": 313300000000,
"birthPlace": "",
"checkedAddressBean": {},
"dateOfBirthCheckDigit": "",
"documentFrontSubtype": "NATIONAL_PASSPORT",
"documentNumber": "",
"documentNumberCheckDigit": "",
"documentSubmissionMethod": "",
"expirationDate": ,
"expirationDateCheckDigit": "",
"expireAt": "",
"fullNameMrz": "",
"gender": "M",
"issueDate": 2023,
"issueFront": 2013,
"issuedAt": "",
"issuingAuthority": "",
"issuingCountry": "",
"mrz1": "",
"mrz2": "",
"name": {
"firstName": "",
"fullName": "",
"givenName": "",
"givenNameMrz": "",
"lastNameMrz": "",
"machineReadableFullName": "",
"maternalLastName": "",
"paternalLastName": ""
},
"nationality": "CHILENA",
"nationalityAlpha3": "CHL",
"nationalityMrz": "CHL",
"notExtractedDetails": [],
"ocrDataConfidence": {
"backNumberConfidence": 0.91822916,
"birthDateConfidence": 0.91822916,
"birthPlaceConfidence": 0.9865,
"countryCodeConfidence": 0.91822916,
"documentNumberConfidence": 0.91822916,
"expirationDateConfidence": 0.91822916,
"expireAtConfidence": 0.91822916,
"fathersSurnameConfidence": 0.99,
"firstNameConfidence": 0.988,
"genderConfidence": 0.91822916,
"givenNameConfidence": 0.988,
"issueDateConfidence": 0.99,
"issuedAtConfidence": 0.99,
"issuingAuthorityConfidence": 0.97783333,
"mothersSurnameConfidence": 0.991,
"mrz1Confidence": 0.896125,
"mrz2Confidence": 0.9403333,
"mrzFullConfidence": 0.9150715,
"nationalityAlpha3Confidence": 0.970943,
"nationalityConfidence": 0.988,
"nationalityMrzConfidence": 0.91822916,
"personalNumberConfidence": 0.91822916
},
"personalNumber": "138291383",
"typeOfId": "Passport"
},
"scoreData": {
"behavioralRisk": {
"overall": {
"status": "OK"
}
},
"deviceRisk": {
"overall": {
"status": "OK"
}
},
"documentOnEdgeInfo": {
"frontDocumentIsOnTheEdge": true
},
"faceRecognition": {
"details": [
{
"result": {
"status": "OK",
"value": "89.0"
},
"type": "selfieVsId"
}
],
"faceBrightness": {
"status": "OK"
},
"hasClosedEyes": {
"status": "OK"
},
"hasHeadCover": {
"status": "OK"
},
"imageQuality": {
"status": "OK"
},
"lensesCheck": {
"status": "OK"
},
"maskCheck": {
"status": "OK",
"value": "0"
},
"overall": {
"status": "OK",
"value": "89.0"
}
},
"idOcrConfidence": {
"overallConfidence": {
"status": "OK",
"value": "91.8"
}
},
"idValidation": {
"idSpecific": [
{
"key": "visiblePhotoFeatures",
"status": "OK",
"value": "100"
},
{
"key": "expirationDateValidity",
"status": "OK",
"value": "100"
},
{
"key": "sexCrosscheck",
"status": "OK",
"value": "100"
},
{
"key": "mrzLineFormatCheck",
"status": "OK",
"value": "100"
},
{
"key": "personalNumberCrosscheck",
"status": "OK",
"value": "100"
},
{
"key": "documentNumberCheckDigit",
"status": "OK",
"value": "100"
},
{
"key": "documentNumberCrosscheck",
"status": "OK",
"value": "100"
},
{
"key": "issueDateValidity",
"status": "OK",
"value": "100"
},
{
"key": "birthDateCrosscheck",
"status": "OK",
"value": "100"
},
{
"key": "mrzParsableCheck",
"status": "OK",
"value": "100"
},
{
"key": "expirationDateCrosscheck",
"status": "OK",
"value": "100"
},
{
"key": "documentClassification",
"status": "OK",
"value": "100"
},
{
"key": "birthDateCheckDigit",
"status": "OK",
"value": "100"
},
{
"key": "documentSeriesExpired",
"status": "OK",
"value": "100"
},
{
"key": "birthDateValidity",
"status": "OK",
"value": "100"
},
{
"key": "fullNameCrosscheck",
"status": "OK",
"value": "100"
},
{
"key": "compositeCheckDigit",
"status": "OK",
"value": "100"
},
{
"key": "expirationDateCheckDigit",
"status": "OK",
"value": "100"
},
{
"key": "documentExpired",
"status": "OK",
"value": "100"
}
],
"overall": {
"status": "OK",
"value": "100.0"
},
"photoSecurityAndQuality": [
{
"key": "tamperCheck",
"status": "OK",
"value": "PASSED"
},
{
"key": "idAlterationCheck",
"status": "OK",
"value": "PASSED"
},
{
"key": "alignment",
"status": "OK",
"value": "PASSED"
},
{
"key": "screenIdLiveness",
"status": "OK",
"value": "OK"
},
{
"key": "paperIdLiveness",
"status": "OK",
"value": "OK"
},
{
"key": "balancedLightFront",
"status": "OK",
"value": "93"
},
{
"key": "sharpnessFront",
"status": "OK",
"value": "93"
},
{
"key": "fakeBrowserCheck",
"status": "OK",
"value": "PASSED"
},
{
"key": "fontAlterationCheck",
"status": "OK",
"value": "PASSED"
},
{
"key": "fakeIdCheck",
"status": "OK",
"value": "PASSED"
},
{
"key": "visibleIdCharacteristicsFront",
"status": "OK",
"value": "PASSED"
},
{
"key": "idDamageDetectionCheck",
"status": "OK",
"value": "PASSED"
}
]
},
"liveness": {
"hasClosedEyes": {
"status": "OK"
},
"hasHeadCover": {
"status": "OK"
},
"livenessScore": {
"status": "OK",
"value": "100.0"
},
"overall": {
"status": "OK",
"value": "100.0"
},
"physicalAttack": {
"status": "OK",
"value": "100.0"
},
"spoofDetectionMethod": "SF"
},
"overall": {
"status": "OK",
"value": "96.3"
},
"reasonMsg": "This session passed because it passed all of Incode's tests: Face Recognition, Liveness Detection, ID Verification",
"retryInfo": {},
"sessionRecording": {
"mergedRecordingQualityChecks": {}
}
},
"imageData": {
"croppedFrontID": "",
"selfie": "",
"selfie_prevAttempts": {
"1783718302471": ""
}
}
}
sidebar. Driver's license response example
{
"authenticationId": "8a84e6c3-12aa-4d18-885d-e896875a165e",
"ocrData": {
"address": "180 MASON DR COBB, GA 31735-2111 SUMTER",
"addressFields": {
"state": "GA"
},
"birthDate": 791596800000,
"checkedAddress": "180 Mason Dr, Cobb, GA 317352111, United States",
"checkedAddressBean": {
"addressCountryCode": "USA",
"city": "Cobb",
"label": "180 Mason Dr, Cobb, GA 317352111, United States",
"latitude": 31.96557,
"longitude": -83.94021,
"postalCode": "317352111",
"state": "GA",
"stateName": "Georgia",
"street": "180 Mason Dr",
"zipColonyOptions": []
},
"classes": "C",
"documentBackSubtype": "DRIVERS_LICENSE",
"documentFrontSubtype": "DRIVERS_LICENSE",
"documentNumber": "057262887",
"documentSubmissionMethod": "CAPTURED_DOCUMENT",
"expirationDate": 2030,
"expireAt": "1896134400000",
"eyeColor": "BLU",
"gender": "F",
"height": "5 103 ",
"issueBack": 2019,
"issueDate": 2022,
"issueFront": 2019,
"issuedAt": "1644019200000",
"issuingCountry": "USA",
"issuingState": "GEORGIA",
"name": {
"firstName": "IDINSTATE",
"fullName": "IDINSTATE MIDDLE ADAMS",
"givenName": "IDINSTATE MIDDLE",
"middleName": "MIDDLE",
"paternalLastName": "ADAMS"
},
"notExtractedDetails": [],
"ocrDataConfidence": {
"addressConfidence": 1,
"birthDateConfidence": 0.99,
"classesConfidence": 0.999,
"documentNumberConfidence": 1,
"expirationDateConfidence": 0.99,
"expireAtConfidence": 0.99,
"eyeColorConfidence": 1,
"fathersSurnameConfidence": 1,
"firstNameConfidence": 1,
"genderConfidence": 1,
"givenNameConfidence": 1,
"heightConfidence": 0.91566664,
"issueDateConfidence": 0.99,
"issuedAtConfidence": 0.99,
"middleNameConfidence": 1,
"nameConfidence": 1,
"refNumberConfidence": 1,
"restrictionsConfidence": 0.999,
"weightConfidence": 0.9965
},
"refNumber": "383181768481435036",
"restrictions": "A",
"typeOfId": "DriversLicense",
"weight": "135 Ib"
},
"scoreData": {
"behavioralRisk": {
"overall": {
"status": "OK"
}
},
"deviceRisk": {
"overall": {
"status": "OK"
}
},
"documentOnEdgeInfo": {
"backDocumentIsOnTheEdge": false,
"frontDocumentIsOnTheEdge": false
},
"faceRecognition": {
"customerId": "69fb804c2d5d4345eff29e37",
"details": [
{
"result": {
"status": "FAIL",
"value": "0.0"
},
"type": "selfieVsId"
}
],
"exactFaceMatch": {
"status": "OK",
"value": "0.0"
},
"existingInterviewId": "69fb7f6d545f1d5cd99abddb",
"existingUser": true,
"faceBrightness": {
"status": "OK"
},
"hasClosedEyes": {
"status": "OK"
},
"hasHeadCover": {
"status": "OK"
},
"imageQuality": {
"status": "OK"
},
"lensesCheck": {
"status": "OK"
},
"maskCheck": {
"status": "OK",
"value": "0"
},
"nameMatch": {
"status": "FAIL"
},
"overall": {
"status": "FAIL",
"value": "0.0"
}
},
"idOcrConfidence": {
"overallConfidence": {
"status": "OK",
"value": "99.0"
}
},
"idValidation": {
"idSpecific": [
{
"key": "documentTypeSideCrosscheck",
"status": "OK",
"value": "100"
},
{
"key": "documentSeriesExpired",
"status": "OK",
"value": "100"
},
{
"key": "birthDateValidity",
"status": "OK",
"value": "100"
},
{
"key": "barcode2DDetected",
"status": "FAIL",
"value": "0"
},
{
"key": "2DBarcodeContent",
"status": "FAIL",
"value": "0"
},
{
"key": "expirationDateValidity",
"status": "OK",
"value": "100"
},
{
"key": "issueDateValidity",
"status": "OK",
"value": "100"
},
{
"key": "underageCheck",
"status": "OK",
"value": "100"
},
{
"key": "documentExpired",
"status": "OK",
"value": "100"
}
],
"overall": {
"status": "FAIL",
"value": "0.0"
},
"photoSecurityAndQuality": [
{
"key": "tamperCheck",
"status": "OK",
"value": "PASSED"
},
{
"key": "idAlterationCheck",
"status": "OK",
"value": "PASSED"
},
{
"key": "alignment",
"status": "OK",
"value": "PASSED"
},
{
"key": "screenIdLiveness",
"status": "OK",
"value": "OK"
},
{
"key": "paperIdLiveness",
"status": "FAIL",
"value": "FAIL"
},
{
"key": "balancedLightFront",
"status": "OK",
"value": "87"
},
{
"key": "balancedLightBack",
"status": "OK",
"value": "95"
},
{
"key": "sharpnessFront",
"status": "OK",
"value": "88"
},
{
"key": "sharpnessBack",
"status": "OK",
"value": "83"
},
{
"key": "fakeBrowserCheck",
"status": "OK",
"value": "PASSED"
},
{
"key": "punchedHoles",
"status": "OK",
"value": "PASSED"
},
{
"key": "fakeIdCheck",
"status": "OK",
"value": "PASSED"
},
{
"key": "visibleIdCharacteristicsFront",
"status": "OK",
"value": "PASSED"
},
{
"key": "visibleIdCharacteristicsBack",
"status": "OK",
"value": "PASSED"
},
{
"key": "idLaminationCheck",
"status": "OK",
"value": "PASSED"
}
]
},
"liveness": {
"digitalAttack": {
"status": "OK",
"value": "97.2"
},
"evasionAttack": {
"status": "OK",
"value": "100.0"
},
"hasClosedEyes": {
"status": "OK"
},
"hasHeadCover": {
"status": "OK"
},
"livenessScore": {
"status": "OK",
"value": "99.9"
},
"overall": {
"status": "OK",
"value": "99.9"
},
"physicalAttack": {
"status": "OK",
"value": "99.9"
},
"spoofDetectionMethod": "SF"
},
"overall": {
"status": "FAIL",
"value": "0.0"
},
"reasonMsg": "This session failed because of ID Verification, Face Recognition",
"retryInfo": {},
"sessionRecording": {
"mergedRecordingQualityChecks": {}
}
},
"imageData": {
"croppedBackID": "https://incode-omni-images.s3.amazonaws.com/demo-k8s/949b1c34a3abc3e6762cac9c67ce642c33c1f5a0/croppedBackID/c8c06b6d-0c58-4000-a2ff-85ed0c90f094.jpg?response-cache-control=no-cache%2Cno-store%2Cmust-revalidate&X-Amz-Security-Token=IQoJb3JpZ2luX2VjEPT%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEaCXVzLWVhc3QtMSJGMEQCICqQsT1i3%2F0X9VMB8Ujc5%2B0FdPPzfDCF8ubDSbfyxjIQAiBWtvp584jSZnmVEcRAH2H%2Fx78zWW9hUcGzlduBXrmQsSqTBQi9%2F%2F%2F%2F%2F%2F%2F%2F%2F%2F8BEAAaDDMzOTcxMzA0OTE5MSIMn9kwFW4kc7IRqAOmKucE7lYQ4%2FzaC5hJQVWnEaG3FB2Tikk3VxM%2BgxHBOmEG3m67NoSDAoQtCw6f1leh2K7ynLmwI7igWJ4L0ardEcnoPj%2Bc5LRpjHAJx1C4o8SiKlCBrcZo7fasOmAjE8FuaCQOWScQ1Sb1%2B4QzCkJZMR41uXYKkW%2FPoQ3nh%2BkZX99ktgT%2BudPTiH99dBgi4t6zrZgEjriw%2FTarHN6mscFyHu%2FRbSEoQ9N68LSis7FOlAiAfImjvS%2FHBCX%2F%2FEOzskyuCYnar8UITvDOhZhq2d36lIqWt%2FLF7TU9qCnJm1MoMJ%2BTCVH1GRJX%2FZWatnPkUeYUAvsKnj9PwggW5h3DYCTMntmxyHO0tktLu7yf1jJzXmK4WnQgWHULU7oCPFFpJH0gyp%2Blc2DZqy9ZcLml%2BwaaqM0CDhF3AiYT4bOUIPgfZ1i1hN3g9r3K6e36lOs4fqbAm964hdvrgrm%2Bk5rLsCcHzgNAjt%2BGJUODJC3tw7Yv1BznGrkwi53%2BCuGdKuV8%2BKrbzEu8XVUEgfwqqCRelnIT94u1fVNy3ugJX36KYDT8RDlOh%2FJ30ItkX66MVYQ%2B3JdvTgetOTUvOYc5e28%2BFfHKo0TyaRNFcPiyM4m1Sv6Pu1er2ZVLqFdwUTzgTYl5wmq0J%2Be%2FpNBbWfWMN0uhgJ71Skmigh2xKVCy3X8brFl60w19u9Jd84ocKhwuMJ24nfI9QbNPn02nnQPBgf3gIDn16n58L3V2BZG7BXE%2BGn1SV07DYtUO6mbtnq11EJEAnmnlwlSmA%2BzZL2k0ycvZWUmj2QQ5nDfBo37C9r8e%2BlcjzRHgmnCCAG7voMA3MJjg888GOpoBfFcdR6FrSWLQS%2BmCmx4D2MWOkbZTUQiAYTKZyszTdk1TxVmPhGW%2BOM3B%2F4Q2qFa3OIisrRdg01zqZ%2BOgTKWMntzHQ5dfBkLPE5h29saLY1X6hhFi78kwZvM%2FGQ7pSbEsZlqEtRIQ2T5ntiiu6IEcmjBy5AeRMwC%2BbXsSuLws0jljErl48CGJqHjFjrPa54sR%2FXZpTCUi2l4S%2Fg%3D%3D&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20260507T203527Z&X-Amz-SignedHeaders=host&X-Amz-Expires=3600&X-Amz-Credential=ASIAU6GDZYJTVZR5XHPA%2F20260507%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Signature=0e3f0b9bc9dd716d9bbc98bbe968fce982f8369f762e96f0f7d9571c304dffb1",
"croppedFrontID": "https://incode-omni-images.s3.amazonaws.com/demo-k8s/949b1c34a3abc3e6762cac9c67ce642c33c1f5a0/croppedFrontID/e35a36dd-7f13-4092-a59b-1abeb5228156.jpg?response-cache-control=no-cache%2Cno-store%2Cmust-revalidate&X-Amz-Security-Token=IQoJb3JpZ2luX2VjEPT%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEaCXVzLWVhc3QtMSJGMEQCICqQsT1i3%2F0X9VMB8Ujc5%2B0FdPPzfDCF8ubDSbfyxjIQAiBWtvp584jSZnmVEcRAH2H%2Fx78zWW9hUcGzlduBXrmQsSqTBQi9%2F%2F%2F%2F%2F%2F%2F%2F%2F%2F8BEAAaDDMzOTcxMzA0OTE5MSIMn9kwFW4kc7IRqAOmKucE7lYQ4%2FzaC5hJQVWnEaG3FB2Tikk3VxM%2BgxHBOmEG3m67NoSDAoQtCw6f1leh2K7ynLmwI7igWJ4L0ardEcnoPj%2Bc5LRpjHAJx1C4o8SiKlCBrcZo7fasOmAjE8FuaCQOWScQ1Sb1%2B4QzCkJZMR41uXYKkW%2FPoQ3nh%2BkZX99ktgT%2BudPTiH99dBgi4t6zrZgEjriw%2FTarHN6mscFyHu%2FRbSEoQ9N68LSis7FOlAiAfImjvS%2FHBCX%2F%2FEOzskyuCYnar8UITvDOhZhq2d36lIqWt%2FLF7TU9qCnJm1MoMJ%2BTCVH1GRJX%2FZWatnPkUeYUAvsKnj9PwggW5h3DYCTMntmxyHO0tktLu7yf1jJzXmK4WnQgWHULU7oCPFFpJH0gyp%2Blc2DZqy9ZcLml%2BwaaqM0CDhF3AiYT4bOUIPgfZ1i1hN3g9r3K6e36lOs4fqbAm964hdvrgrm%2Bk5rLsCcHzgNAjt%2BGJUODJC3tw7Yv1BznGrkwi53%2BCuGdKuV8%2BKrbzEu8XVUEgfwqqCRelnIT94u1fVNy3ugJX36KYDT8RDlOh%2FJ30ItkX66MVYQ%2B3JdvTgetOTUvOYc5e28%2BFfHKo0TyaRNFcPiyM4m1Sv6Pu1er2ZVLqFdwUTzgTYl5wmq0J%2Be%2FpNBbWfWMN0uhgJ71Skmigh2xKVCy3X8brFl60w19u9Jd84ocKhwuMJ24nfI9QbNPn02nnQPBgf3gIDn16n58L3V2BZG7BXE%2BGn1SV07DYtUO6mbtnq11EJEAnmnlwlSmA%2BzZL2k0ycvZWUmj2QQ5nDfBo37C9r8e%2BlcjzRHgmnCCAG7voMA3MJjg888GOpoBfFcdR6FrSWLQS%2BmCmx4D2MWOkbZTUQiAYTKZyszTdk1TxVmPhGW%2BOM3B%2F4Q2qFa3OIisrRdg01zqZ%2BOgTKWMntzHQ5dfBkLPE5h29saLY1X6hhFi78kwZvM%2FGQ7pSbEsZlqEtRIQ2T5ntiiu6IEcmjBy5AeRMwC%2BbXsSuLws0jljErl48CGJqHjFjrPa54sR%2FXZpTCUi2l4S%2Fg%3D%3D&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20260507T203527Z&X-Amz-SignedHeaders=host&X-Amz-Expires=3600&X-Amz-Credential=ASIAU6GDZYJTVZR5XHPA%2F20260507%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Signature=e22551355773a92418577b564da82a9989a3cf5fc9be9da92331f2fc737beee4",
"selfie": "https://incode-omni-images.s3.amazonaws.com/demo-k8s/949b1c34a3abc3e6762cac9c67ce642c33c1f5a0/selfie/51103004-9957-4499-97df-996ccf98bd6b.jpg?response-cache-control=no-cache%2Cno-store%2Cmust-revalidate&X-Amz-Security-Token=IQoJb3JpZ2luX2VjEPT%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEaCXVzLWVhc3QtMSJGMEQCICqQsT1i3%2F0X9VMB8Ujc5%2B0FdPPzfDCF8ubDSbfyxjIQAiBWtvp584jSZnmVEcRAH2H%2Fx78zWW9hUcGzlduBXrmQsSqTBQi9%2F%2F%2F%2F%2F%2F%2F%2F%2F%2F8BEAAaDDMzOTcxMzA0OTE5MSIMn9kwFW4kc7IRqAOmKucE7lYQ4%2FzaC5hJQVWnEaG3FB2Tikk3VxM%2BgxHBOmEG3m67NoSDAoQtCw6f1leh2K7ynLmwI7igWJ4L0ardEcnoPj%2Bc5LRpjHAJx1C4o8SiKlCBrcZo7fasOmAjE8FuaCQOWScQ1Sb1%2B4QzCkJZMR41uXYKkW%2FPoQ3nh%2BkZX99ktgT%2BudPTiH99dBgi4t6zrZgEjriw%2FTarHN6mscFyHu%2FRbSEoQ9N68LSis7FOlAiAfImjvS%2FHBCX%2F%2FEOzskyuCYnar8UITvDOhZhq2d36lIqWt%2FLF7TU9qCnJm1MoMJ%2BTCVH1GRJX%2FZWatnPkUeYUAvsKnj9PwggW5h3DYCTMntmxyHO0tktLu7yf1jJzXmK4WnQgWHULU7oCPFFpJH0gyp%2Blc2DZqy9ZcLml%2BwaaqM0CDhF3AiYT4bOUIPgfZ1i1hN3g9r3K6e36lOs4fqbAm964hdvrgrm%2Bk5rLsCcHzgNAjt%2BGJUODJC3tw7Yv1BznGrkwi53%2BCuGdKuV8%2BKrbzEu8XVUEgfwqqCRelnIT94u1fVNy3ugJX36KYDT8RDlOh%2FJ30ItkX66MVYQ%2B3JdvTgetOTUvOYc5e28%2BFfHKo0TyaRNFcPiyM4m1Sv6Pu1er2ZVLqFdwUTzgTYl5wmq0J%2Be%2FpNBbWfWMN0uhgJ71Skmigh2xKVCy3X8brFl60w19u9Jd84ocKhwuMJ24nfI9QbNPn02nnQPBgf3gIDn16n58L3V2BZG7BXE%2BGn1SV07DYtUO6mbtnq11EJEAnmnlwlSmA%2BzZL2k0ycvZWUmj2QQ5nDfBo37C9r8e%2BlcjzRHgmnCCAG7voMA3MJjg888GOpoBfFcdR6FrSWLQS%2BmCmx4D2MWOkbZTUQiAYTKZyszTdk1TxVmPhGW%2BOM3B%2F4Q2qFa3OIisrRdg01zqZ%2BOgTKWMntzHQ5dfBkLPE5h29saLY1X6hhFi78kwZvM%2FGQ7pSbEsZlqEtRIQ2T5ntiiu6IEcmjBy5AeRMwC%2BbXsSuLws0jljErl48CGJqHjFjrPa54sR%2FXZpTCUi2l4S%2Fg%3D%3D&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20260507T203527Z&X-Amz-SignedHeaders=host&X-Amz-Expires=3600&X-Amz-Credential=ASIAU6GDZYJTVZR5XHPA%2F20260507%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Signature=88fc19c7164d0087cf766e32344902321daa5e99c93288da514c09fbe881d752",
"selfie_prevAttempts": {
"1778185939851": "https://incode-omni-images.s3.amazonaws.com/demo-k8s/949b1c34a3abc3e6762cac9c67ce642c33c1f5a0/selfie/51103004-9957-4499-97df-996ccf98bd6b.jpg?response-cache-control=no-cache%2Cno-store%2Cmust-revalidate&X-Amz-Security-Token=IQoJb3JpZ2luX2VjEPT%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEaCXVzLWVhc3QtMSJGMEQCICqQsT1i3%2F0X9VMB8Ujc5%2B0FdPPzfDCF8ubDSbfyxjIQAiBWtvp584jSZnmVEcRAH2H%2Fx78zWW9hUcGzlduBXrmQsSqTBQi9%2F%2F%2F%2F%2F%2F%2F%2F%2F%2F8BEAAaDDMzOTcxMzA0OTE5MSIMn9kwFW4kc7IRqAOmKucE7lYQ4%2FzaC5hJQVWnEaG3FB2Tikk3VxM%2BgxHBOmEG3m67NoSDAoQtCw6f1leh2K7ynLmwI7igWJ4L0ardEcnoPj%2Bc5LRpjHAJx1C4o8SiKlCBrcZo7fasOmAjE8FuaCQOWScQ1Sb1%2B4QzCkJZMR41uXYKkW%2FPoQ3nh%2BkZX99ktgT%2BudPTiH99dBgi4t6zrZgEjriw%2FTarHN6mscFyHu%2FRbSEoQ9N68LSis7FOlAiAfImjvS%2FHBCX%2F%2FEOzskyuCYnar8UITvDOhZhq2d36lIqWt%2FLF7TU9qCnJm1MoMJ%2BTCVH1GRJX%2FZWatnPkUeYUAvsKnj9PwggW5h3DYCTMntmxyHO0tktLu7yf1jJzXmK4WnQgWHULU7oCPFFpJH0gyp%2Blc2DZqy9ZcLml%2BwaaqM0CDhF3AiYT4bOUIPgfZ1i1hN3g9r3K6e36lOs4fqbAm964hdvrgrm%2Bk5rLsCcHzgNAjt%2BGJUODJC3tw7Yv1BznGrkwi53%2BCuGdKuV8%2BKrbzEu8XVUEgfwqqCRelnIT94u1fVNy3ugJX36KYDT8RDlOh%2FJ30ItkX66MVYQ%2B3JdvTgetOTUvOYc5e28%2BFfHKo0TyaRNFcPiyM4m1Sv6Pu1er2ZVLqFdwUTzgTYl5wmq0J%2Be%2FpNBbWfWMN0uhgJ71Skmigh2xKVCy3X8brFl60w19u9Jd84ocKhwuMJ24nfI9QbNPn02nnQPBgf3gIDn16n58L3V2BZG7BXE%2BGn1SV07DYtUO6mbtnq11EJEAnmnlwlSmA%2BzZL2k0ycvZWUmj2QQ5nDfBo37C9r8e%2BlcjzRHgmnCCAG7voMA3MJjg888GOpoBfFcdR6FrSWLQS%2BmCmx4D2MWOkbZTUQiAYTKZyszTdk1TxVmPhGW%2BOM3B%2F4Q2qFa3OIisrRdg01zqZ%2BOgTKWMntzHQ5dfBkLPE5h29saLY1X6hhFi78kwZvM%2FGQ7pSbEsZlqEtRIQ2T5ntiiu6IEcmjBy5AeRMwC%2BbXsSuLws0jljErl48CGJqHjFjrPa54sR%2FXZpTCUi2l4S%2Fg%3D%3D&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20260507T203527Z&X-Amz-SignedHeaders=host&X-Amz-Expires=3600&X-Amz-Credential=ASIAU6GDZYJTVZR5XHPA%2F20260507%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Signature=88fc19c7164d0087cf766e32344902321daa5e99c93288da514c09fbe881d752"
}
}
}