create-session

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

Call it from the client backend, return session_id to the app and start the RS-ID SDK with it.

Modes

With user_info — the SDK only opens the camera.

Without user_info — the SDK asks the user to enter their data, then opens the camera.

With an earlier session_id — repeat verification with the citizen data of an earlier session of your client; the SDK only opens the camera.

Rules

client_type must be MOBILE; credentials must belong to a Mobile SDK client.

No IP binding and no redirect_url — the result comes back to the app from the SDK.

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

session_id must be your own client's session; ignored if user_info is sent.

additional_params accepts only lang, theme, primary_color.

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

Authorization: Bearer {access_token}.

curl --location --globoff '{{base_url}}/v1/sessions' \ --header 'Content-Type: application/json' \ --data '{ "client_type": "MOBILE", "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": { "lang": "uz", "theme": "light", "primary_color": "#1A73E8" } }'

Request

Responses