Retrieve a Document Liveness

GET https://api.verifik.co/v2/document-liveness/{id}

With this service, you can bring all document liveness validations that you have processed or if you only want one, you can specify the ID of the document liveness record and the endpoint will return only the selected validation result.

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Query Parameters

Name	Type	Description
id	string	ID of the Document Liveness record that you want to bring the information.

Request

Python

import http.client

payload = ""
headers = {"Authorization": "Bearer eyJhbGciOiJIXVCJ9.eyJjbGllbn...lt4Cw"}

conn = http.client.HTTPSConnection("api.verifik.co")
conn.request("GET", "/v2/document-liveness/<id>", payload, headers)

res = conn.getresponse()

data = res.read()

print(data.decode("utf-8"))

Node.js

const axios = require("axios");

const config = {
    method: "get",
    url: "https://api.verifik.co/v2/document-liveness/<id>",
    maxBodyLength: Infinity,
    headers: {
        Authorization: "Bearer eyJhbGciOiXVCJ9.eyJjbGllbnR...w1splt4Cw",
    },
};

axios
    .request(config)
    .then((response) => console.log(JSON.stringify(response.data)))
    .catch((error) => console.error(error));

Response

200

{
    "data": {
        "_id": "68a8bf34d8207d5f3357b643",
        "client": "613375a1eab2fe08527f81e2",
        "imageSaved": true,
        "imageUrl": "https://cdn.verifik.co/document-liveness/document-liveness-1755889460500",
        "validateScreenReplay": true,
        "validatePrintedCopy": true,
        "validatePortraitSubstitution": true,
        "validateDigitalManipulation": true,
        "sreenReplayScore": 0.4201007,
        "printedCopyScore": 2.7406464,
        "portraitSubstitutionScore": 10.7250834,
        "digitalManipulationScore": -0.124236,
        "screenReplayProbability": 0.0019733,
        "printedCopyProbability": 0.000001,
        "portraitSubstitutionProbability": 0.948844,
        "digitalManipulationProbability": 0.3582724,
        "sreenReplayCalibration": "REGULAR",
        "printedCopyCalibration": "REGULAR",
        "portraitSubstitutionCalibration": "REGULAR",
        "digitalManipulationCalibration": "REGULAR",
        "ignoreDocumentCroppedValidation": false,
        "ignoreColourLessValidation": false,
        "screenReplayWarnings": [
            "GLARE_ON_IMAGE"
        ],
        "printedCopyWarnings": [
            "GLARE_ON_IMAGE"
        ],
        "portraitSubstitutionWarnings": [
            "GLARE_ON_IMAGE"
        ],
        "digitalManipulationWarnings": [
            "GLARE_ON_IMAGE"
        ],
        "screenReplayErrors": [],
        "printedCopyErrors": [],
        "portraitSubstitutionErrors": [],
        "digitalManipulationErrors": [],
        "aggregatedScore": 0.000001,
        "updatedAt": "2025-08-22T19:04:25.503Z",
        "createdAt": "2025-08-22T19:04:25.503Z",
        "__v": 0
    }
}

404

{
    "message": "Record not found.",
    "code": "NotFound"
}

401

{
    "error": "Protected resource, use Authorization header to get access"
}