Details

Details lets you access the verification response of a given session

get
Document details

https://identity-api.synaps.io/v2/identity/details
Get associated Session-Id details
Request
Response
Request
Headers
Api-Key
required
string
Synaps application Api-Key
Session-Id
required
string
Initialized Session-Id
Response
200: OK
Success
{
"session_id": "ca9fc5fd-421d-6990-6f84-15c3b67b"
}

API Response

Field

Type

Description

verification

VerificationObject

Complete verification structure

session_id

string

Session ID of the identity verification

aml

AmlObject

AML Structure available in AML Check Structure Page

state

string

PENDING - Identity in review

VALIDATED - Identity valid

REJECTED - Identity rejected

NOT_STARTED - Identity not yet submitted

history

HistoryArray

Array of history containing all previous verification and reason of invalidity

front_file

string

Synaps Signed Link of the Front File (expires 15min after request)

back_file

string

Synaps Signed Link of the Back File (expires 15min after request)

HistoryArray

Field

Type

Description

notice_date

date

Date of verification

state

string

PENDING - Identity in review

VALIDATED - Identity valid

REJECTED - Identity rejected

NOT_STARTED - Identity not yet submitted

review

string

Empty if VALIDATED

Review message explaining the reason of verification incompletion

VerificationObject

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 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

InfoObject Standard information of a processed identity verification

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

IdentityInfoObject Value of extracted information

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

FeaturesArray Array of features

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

SecurityFeaturesArray Array of document security features

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

DocumentDataArray Array of document data features

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

MrzArray Array of document MRZ (Machine Readable Zone)

Field

Type

Description

value

string

Name of the Machine Readable Zone

confidence_score

number

Percentage (0 to 1) of our 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