Verification Data

When you perform a Know Your Customer (KYC) verification using the Faceki API, you receive a detailed verification response containing valuable information about the verification process, document authenticity, facial matching, and more. This documentation aims to help you understand the different fields present in the response and their significance.

Document Verification Result Structure

`link`

A unique identifier or reference for the document.

`record_identifier`

A unique identifier is associated with the record by a customer while requesting through API or SDK

`requestId`

A unique identifier for the request associated with the document generated by Faceki (UUIDV4)

`document_data`

An array containing information about the document. Each element represents a document with the following details:

reference: A unique identifier for the document.
full_name: Full name of the individual.
first_name: First name of the individual.
local_name: Local name (In Local Language)
last_name: Last name of the individual.
middle_name: Middle name of the individual.
nationality: Nationality of the individual.
nationality_iso: ISO code for nationality. (corresponds to ISO2)
nationality_iso2: Another ISO code for nationality. (corresponds to ISO3)
issuer: Entity or country that issued the document.
issuer_iso: ISO code for the issuer. (corresponds to ISO2)
issuer_iso2: Another ISO code for the issuer. (corresponds to ISO3)
gender: Gender of the individual.
dob: Date of birth in a partial format.
age: Age of the individual.
expiry: Expiry date of the document.
issued: Date when the document was issued.
document_number: Document number.
document_type: Type code for the document.
document_type_full: Full name or description of the document.
mrz: Machine Readable Zone information from the document.
document_face_match: Information about the match between the document photo and facial image.
passed: Boolean indicating if document verification passed.
date_of_birth: Date of birth in formatted form.
date_of_birth_day: Day component of the date of birth.
date_of_birth_month: Month component of the date of birth.
date_of_birth_year: Year component of the date of birth.
sponsor_local: Local name or identifier of the sponsor (in the local language) associated with the individual’s document. This field is optional and only used in cases where a sponsor is involved.
sponsor: Name of the sponsor related to the individual. This could refer to a person or organization responsible for or linked to the document's issuance or the individual's verification process.
nationality_local: The nationality of the individual in a local language or code, used in systems where the local representation of the nationality is needed alongside standard ISO codes.
profession_local: The individual's profession in a local language or format, which may differ from standardized professions, used in local contexts.
profession: Name representing the individual’s profession, used for verification and record purposes.
serial_number: A serial number linked to the document or verification process, typically used to track the document or verification instance.
additionalExpiry: An additional expiry date for the document or related verification, used when there are multiple layers of expiry associated with different parts of the document (e.g., visa expiry versus passport expiry).

`selfie_data`

Information about selfie verification.

liveness_pass: Boolean indicating if the selfie liveness verification passed.

`warnings`

Array of warnings associated with the document verification.

`notes`

Array of notes associated with the document verification.

`aml`

An array of Anti Money Laundering (AML) information is associated with the document verification.

name: The full name of the individual as recorded.
localName: The local or native name of the individual, if different from the full name.
first_name: The individual's given (first) name.
last_name: The individual's family (surname) or last name.
middle_name: The individual's middle name, if applicable.
type: The type of individual; in this case, it is a PEP (Politically Exposed Person). SANCTION, WATCHLIST, CUSTOM BLACK LIST
positions: The political position or role held by the individual, along with the start date of the position.
name_title: A title associated with the individual, such as Mr., Dr., or any honorific. In this
listed_on: The date when the individual was listed as a Politically Exposed Person (PEP).
nationality: The country of nationality of the individual.
year_of_birth: The birth year of the individual, if available.
place_of_birth: The place where the individual was born, if available.
place_of_birth_city: The specific city where the individual was born, if available.
place_of_birth_state: The specific state or region where the individual was born, if available.
alias_name: Alternative names or aliases by which the individual is known.
list_name: The name of the list that the individual is part of.
reason: The reason for the individual being listed or classified, often indicating their role or position of influence
additional: Additional information or notes regarding the individual, if any.
entity: Indicates whether the record pertains to an individual or organization.
documents: Any documents or supporting files attached to the record.
- doc_type: Turkish Identification Number
- doc_number: 15673320164
- doc_country: Turkey

`verification_summary`

Summary of various verification checks.

face_verified: Boolean indicating if face verification passed.
selfie_liveness_verified: Boolean indicating if selfie liveness verification passed.
document_verified: Boolean indicating if document verification passed.
verification_rules_passed: Boolean indicating if general verification rules passed.
document_liveness_verified: Boolean indicating if document liveness verification passed.
image_quality: Boolean indicating if image quality is satisfactory.

`document_data_confidence`

An array provides confidence levels for different fields in the document.

Each field in the document has a confidence score ranging from 0 to 1.

`decision`

The decision is based on the verification process (e.g., "DECLINED").

`errorCodes`

The array of error codes associated with the verification process.

`deviceDetails`

Information about the device used for the verification.

useragent: User-agent information.
detectResult: Details about the client and device.

`createdAt`

A timestamp indicating when the document verification request was created.

`updatedAt`

A timestamp indicating when the document verification request was last updated.

`images`

The array of objects contains the following information:

1. Cropped Signature Image

documentName: "Type of document (ID_Card, Passport, Driving License)"
side: "cropped_signature"
key: [Image URL]

2. Cropped Portrait Image

documentName: "Type of document (ID_Card, Passport, Driving License)"
side: "cropped_portrait"
key: [Image URL]

3. Cropped Front Image

documentName: "Type of document (ID_Card, Passport, Driving License)"
side: "cropped_front"
key: [Image URL]

4. Front Image

documentName:"Type of document (ID_Card, Passport, Driving License)"
side: "front"
key: [Image URL]

5. Back Image

documentName: "Type of document (ID_Card, Passport, Driving License)"
side: "back"
key: [Image URL]

6. Cropped Back Image

documentName: "Type of document (ID_Card, Passport, Driving License)"
side: "cropped_back"
key: [Image URL]

Selfie Image:

7. Selfie Image

documentName: "Selfie"
side: "Selfie"
key: [Image URL]

`face_id`

Unique identifier for the face image.

`updateBy`

Information about who updated the document verification record.

Need Support?

PreviousFetch PDF Report NextError Codes

Last updated 24 days ago