Option 2 — compare two photos with citizen data

POST

{{base_url}}/v1/authentication/async/compare-images

Compares two photos sent by the client with each other. The citizen is identified by user_info.

Citizen personal details are not returned in the result.

Authorization: Bearer {access_token}.

Idempotency-Key: required.

Set is_spoofing_required: true on a live selfie, keep false on a document photo.

Request

Authorization

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Request accepted. code = 0 (finished) or -200 (still processing) with data = session_id; errors found during processing also come with HTTP 200 and a negative code. code = 0 is not the verdict — check the result with GET /v1/user/{session_id}.

Bodyapplication/json

🟠400

🟠401

🟠409

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location --globoff '{{base_url}}/v1/authentication/async/compare-images' \
--header 'Idempotency-Key: 6b1c2f0e-1d7a-4c4b-9c35-2f6b9a1e8d01' \
--header 'Content-Type: application/json' \
--data '{
    "original_photo": {
        "order": 1,
        "is_spoofing_required": true,
        "photo": "/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAgGBgcGBQgHBwcJCQgKDBQNDAsLDBkSEw8U..."
    },
    "reference_photo": {
        "order": 2,
        "is_spoofing_required": false,
        "photo": "iVBORw0KGgoAAAANSUhEUgAAAZAAAAGQCAYAAACAvzbMAAAACXBIWXMAAAsTAAALEwEAmpwY..."
    },
    "user_info": {
        "pinfl": "31205901234567",
        "birth_date": "12.05.1990"
    },
    "threshold": 0.7,
    "external_id": "c4e8a1f2-7b3d-4e6a-9f0c-2b5d8e1a4c77"
}'

Response Example

200 - Finished — read the result with GET /v1/user/{session_id}

{
    "data": "a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
    "code": 0,
    "message": "Success"
}

Modified at 2026-11-10 09:18:57

Option 1 — compare photo with passport photo

Option 3 — compare two photos without citizen data