Details

Field

Type

Description

verification

VerificationObject

Complete verification structure

session_id

string

Session ID of the identity verification

Field

Type

Description

info

InfoObject

Person identity information

valid

boolean

true if there is no inconsistency,

missing information or expiration

authenticity_score

number

overall score of the processed verification

based on our AI confidence score and cross

checking score when any

features

FeaturesArray

list of security features, data and MRZ that

must be on the document to be genuine

notices

NoticesArray

list of elements noticed when performing

the identity verification (such as expiration date,

data inconsistency, missing security feature)

Field

Type

Description

firstname

IdentityInfoObject

Legal firstname

lastname

IdentityInfoObject

Legal lastname

birth_date

IdentityInfoObject

Birth Date (Format YYYY-MM-DD)

document_number

IdentityInfoObject

Document number

document_country

IdentityInfoObject

Document country (ISO-3166 format)

document_type

IdentityInfoObject

Document Type (PASSPORT, NATIONAL_ID, DRIVER_LICENSE, RESIDENT_PERMIT)

document_expiration

IdentityInfoObject

Document Expiration Date (Format YYYY-MM-DD)

nationality

IdentityInfoObject

Nationality country (ISO-3166 format) - Empty if document_type is a Driver License

Field

Type

Description

value

string

Value of the field

crosscheck_score

number

Cross-check score (if there is a MRZ, a cross-checking will be processed against OCR value)

cross_checkable

boolean

true if there is multiple source of extraction (OCR + MRZ)

false if there is only one source of extraction (OCR)

​

if cross_checkable is false, crosscheck_score is equal to 0.00

Field

Type

Description

security

SecurityFeaturesArray

list of all security features included in the document

data

DocumentDataArray

list of all document data included in the document

mrz

MrzArray

list of all MRZ (Machine Readable Zone) included

on the document

Field

Type

Description

value

string

Name of the security feature

confidence_score

number

Percentage (0 to 1) of our AI confidence score

included

boolean

true if the feature is included on the document

false if the feature is missing

Field

Type

Description

value

string

Name of the document data field

confidence_score

number

Percentage (0 to 1) of our AI confidence score

included

boolean

true if the feature is included on the document

false if the feature is missing

Field

Type

Description

value

string

Name of the Machine Readable Zone

confidence_score

number

Percentage (0 to 1) of our AI confidence score

included

boolean

true if the feature is included on the document

false if the feature is missing

verified

boolean

true if the MRZ algorithm has been verified

false if the MRZ algorithm is inconsistent

Field

Type

Description

name

string

Name of the element involved

type

number

There is for 4 types of notices: INCONSISTENT : inconsistent data between document (OCR) and MRZ

MISSING : missing element

EXPIRED : expired document UNVERIFIED : element is not verified