Option 3 — compare two photos without citizen data

POST

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

Compares two photos sent by the client without any citizen data. No registry lookup; the result has only the similarity score and note.

Authorization: Bearer {access_token}.

Idempotency-Key: required.

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/face/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..."
    },
    "threshold": 0.7,
    "external_id": "e2a7c9d4-1b6f-4a3e-8c5d-7f0b2e9a6d18"
}'

Response Example

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

{
    "data": "b7c2e1f0-9a8d-4c6b-b5e4-3d2c1b0a9f8e",
    "code": 0,
    "message": "Success"
}

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

Option 2 — compare two photos with citizen data

Get result