create-session

Creates an identification session for one user and returns its session_id.

Call it from the client backend when the user starts identification, then open the RS-ID page: https://sdk.rsid.uz/?session_id={session_id} (stage: https://sdk.stage.rsid.uz/?session_id={session_id}).

Modes

With user_info — you already know the user's data; the RS-ID page only opens the camera.

Without user_info — the RS-ID page asks the user to enter their data, then opens the camera.

Rules

client_type must be WEB.

ip_address is the user's public IP; the session works only from it (-1028).

In user_info send either pinfl or id_number, plus birth_date (dd.MM.yyyy). The user must be 16+.

additional_params accepts only redirect_url, lang, theme, primary_color.

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

The session has a limited lifetime and retry_count attempts.

Authorization: Bearer {access_token}.

curl --location --globoff '{{base_url}}/v1/sessions' \ --header 'Content-Type: application/json' \ --data '{ "client_type": "WEB", "ip_address": "84.54.70.12", "external_id": "9b1d2c7e-4f3a-4b8e-a1c5-6d2f0e9a7b31", "retry_count": 3, "threshold": 0.7, "locale": "UZ", "user_info": { "pinfl": "31205901234567", "birth_date": "12.05.1990" }, "additional_params": { "redirect_url": "https://shop.example.uz/kyc/done?order=ORDER-123", "lang": "uz", "theme": "light", "primary_color": "#1A73E8" } }'

Request

Responses