Option 1 — compare photo with passport photo

POST

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

Compares one user photo with the citizen's passport photo from the state registry. The citizen is found by user_info.

Citizen personal details are not returned in the result.

Authorization: Bearer {access_token}.

Idempotency-Key: required.

is_spoofing_required defaults to false; set true for live selfies. A spoofed photo is reported in note of the result, not as an error here.

threshold: default 0.5; recommended above 0.5, above 0.7 for strict comparison.

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

With PINFLWith document number

curl --location --globoff '{{base_url}}/v1/authentication/async/compare' \
--header 'Idempotency-Key: 6b1c2f0e-1d7a-4c4b-9c35-2f6b9a1e8d01' \
--header 'Content-Type: application/json' \
--data '{
    "photo": "/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAgGBgcGBQgHBwcJCQgKDBQNDAsLDBkSEw8U...",
    "is_spoofing_required": true,
    "user_info": {
        "pinfl": "31205901234567",
        "birth_date": "12.05.1990"
    },
    "threshold": 0.7,
    "external_id": "9b1d2c7e-4f3a-4b8e-a1c5-6d2f0e9a7b31",
    "locale": "UZ"
}'

Response Example

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

{
    "data": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "code": 0,
    "message": "Success"
}

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

refresh

Option 2 — compare two photos with citizen data