Single KYC Verification

KYC Verification API Single Document

Diagram flow e-KYC faceki

Base URL

sdk.faceki.com

KYC Verification End Point API

https://sdk.faceki.com/kycverify/api/kycverify/kyc-verification

Welcome to the developer hub for the FACEKI KYCVerify API. Our API is designed to provide secure and accurate identity verification for your customers. This API call uses the POST method and requires Authorization: Bearer Token for authentication.

To verify national identity, passport, driving license, and other legal documents, simply call the API endpoint at https://sdk.faceki.com/kycverify/api/kycverify/kyc-verification. Our API can perform various security checks and face-matching to ensure the authenticity of the document and its holder.

Our API supports more than 200+ languages and uses an advanced OCR engine to extract all data from the documents. With this level of support, you can confidently verify customer identities from all around the world.

Once you get access to the user dashboard for clientId and clientSecret, the user also has to setup KYC workflow and SDK settings.

Please note that three images are required for verification:

• Document Front image (*Mandatory)

• Document Back image (*Mandatory)

• Face image (*Mandatory)

Method: POST

Authorization: Bearer Token

Parameter:

selfie_image (mandatary)

doc_front_image (mandatary)

doc_back_image (mandatary)

Diagram Steps

To get started with this API, please follow the steps below:

1. Make a POST request to the URL https://sdk.faceki.com/kycverify/api/kycverify/kyc-verification.

2. Set the Authorization type to "Bearer Token" in the request header. You will need to generate a bearer token from /getToken API.

3. In the body of your request, include the following parameters:

• selfie_image (mandatory): This parameter should contain the image of the individual's face to be verified.

• doc_front_image (mandatory): This parameter should contain the image of the front of the identity document to be verified.

• doc_back_image (mandatory): This parameter should contain the image of the back of the identity document to be verified.

1. Send the request to receive a JSON response in the application/JSON format.

POST https://sdk.faceki.com/kycverify/api/kycverify/kyc-verification

Headers

Name	Type	Description
Authorization*	String	[token]
Content-Type*	String	multipart/form-data

Request Body

Name	Type	Description
selfie_image*	File
doc_front_image*	File
doc_back_image*	File

200: OK

{
    "responseCode": 0,
    "data": {
        "verification": {
            "passed": true,
            "result": {
                "face": true,
                "notexpired": true
            }
        },
        "face": {
            "isIdentical": true,
            "confidence": 0.9999440002441407
        },
        "confidence": {
            "backSideId": 1,
            "issuerOrg_full": 1,
            "issuerOrg_iso2": 1,
            "issuerOrg_iso3": 1,
            "document": 0.9222802519798279,
            "documentName": 1,
            "documentNumber": 0.992,
            "documentSide": 1,
            "documentType": 1,
            "face": 0.9468276304459636,
            "face0": 190.1085205078125,
            "firstName": 0.959,
            "fullName": 0.959,
            "internalId": 1,
            "lastName": 0.968,
            "middleName": 0.985,
            "nationality_full": 0.991,
            "reverseId": 1,
            "signature": 0.2879074811935425,
            "signature0": 0.2879074811935425
        },
        "result": {
            "backSideId": "8886",
            "issuerOrg_full": "Bahrain",
            "issuerOrg_iso2": "BH",
            "issuerOrg_iso3": "BHR",
            "document": "",
            "documentName": "Identity Card",
            "documentNumber": "987654321",
            "documentSide": "FRONT",
            "documentType": "I",
            "face": "",
            "face0": "",
            "firstName": "JOHN",
            "fullName": "JOHN DOE",
            "internalId": "437",
            "lastName": "DOE",
            "middleName": "JAMES",
            "nationality_full": "AMERICAN",
            "reverseId": "8886",
            "signature": "",
            "signature0": ""
        },
        "authentication": {
            "breakdown": {
                "recapture_check": {
                    "passed": true
                },
                "data_visibility": {
                    "passed": true
                },
                "image_quality": {
                    "passed": true
                },
                "feature_referencing": {
                    "passed": true
                },
                "exif_check": {
                    "passed": true
                },
                "publicity_check": {
                    "passed": true
                },
                "text_analysis": {
                    "passed": true
                },
                "biometric_analysis": {
                    "passed": true
                },
                "security_feature_check": {
                    "passed": true
                }
            },
            "warning": []
        },
        "aml": [],
        "responseID": "6e9fde27009444d59ce8e4d2e6d5d659",
        "images": {
            "doc_front_image": "imagelink",
            "doc_back_image": "imagelink",
            "selfie_image": "imagelink"
        },
        "link": "client",
        "requestId": "8b62fa2f-9e04-4036-82d5-154c513a5d47"
    }
}

401: Unauthorized

500: Internal Server Error

// Content-Type: application/json

Responses return JSON with a consistent structure, except downloads.

You must make all your requests to the API over HTTPS and TLS 1.2, with Server Name Indication enabled. Any requests made over HTTP will fail.

Error Code

    INTERNAL_SYSTEM_ERROR = 1000,
    SUCCESS = 0,
    NO_RULES_FOR_COMPANY = 7001,
    NEED_REQUIRED_IMAGES = 8001,
    DOCUMENT_VERIFY_FAILED = 8002,
    PLEASE_TRY_AGAIN = 8003,
    FACE_CROPPED = 8004,
    FACE_TOO_CLOSED = 8005,
    FACE_NOT_FOUND = 8006,
    FACE_CLOSED_TO_BORDER = 8007,
    FACE_TOO_SMALL = 8008,
    POOR_LIGHT = 8009,
    ID_VERIFY_FAIL = 8010,
    DL_VERIFY_FAIL = 8011,
    PASSPORT_VERIFY_FAIL = 8012,
    DATA_NOT_FOUND = 8013,
    INVALID_VERIFICATION_LINK = 8014,
    VERIFICATION_LINK_EXPIRED = 8015,
    FAIL_TO_GENERATE_LINK = 8016,
    KYC_VERIFICATION_LIMIT_REACHED = 8017,
    SELFIE_MULTIPLE_FACES = 8018,
    FACE_BLURR = 8019