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.

  • nationality_iso2: Another ISO code for nationality.

  • issuer: Entity or country that issued the document.

  • issuer_iso: ISO code for the issuer.

  • issuer_iso2: Another ISO code for the issuer.

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

Contact us on WhatsApp Click here

PreviousFace Match API (💲)NextError Codes

Last updated