Get user info by code

POST

{{base_url}}/v1/user/by-code

Exchanges the one-time authorization code (received on your redirect_uri after the user signs in on the RS-ID auth page) for the user's verified profile.

Call from your backend only — the request contains client_secret.

Authorization header: not required; the client is authenticated by client_id / client_secret in the body.

The client must be registered in RS-ID as an AUTH project.

The code is valid for 5 minutes and can be used once. If it fails, start the sign-in again.

Use user_info.pinfl as the stable user identifier. Addresses are not returned in this flow (null).

Request

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Verified user profile.

Bodyapplication/json

🟠400

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location --globoff '{{base_url}}/v1/user/by-code' \
--header 'Content-Type: application/json' \
--data '{
    "client_id": "shop-example-auth",
    "client_secret": "s3cr3t-value",
    "code": "Zx81kQ2mP0aB7cD9eF1gH3",
    "grant_type": "authorization_code"
}'

Response Example

200 - Success

{
    "data": {
        "user_info": {
            "first_name": "ALISHER",
            "last_name": "KARIMOV",
            "middle_name": "BAXTIYOROVICH",
            "pinfl": "12345678901234",
            "gender": "MALE",
            "birth_date": "1990-01-01",
            "birth_place": "TOSHKENT",
            "birth_country": null,
            "nationality": null,
            "citizenship": null
        },
        "document_info": {
            "document": "AA1234567",
            "type": "PASSPORT",
            "issued_by": "IIV 26283",
            "issued_at": "2018-05-10",
            "expiry_at": "2028-05-09"
        },
        "contact_info": {
            "phone": "998901234567",
            "email": "alisher.karimov@example.uz"
        },
        "permanent_address": null,
        "temporary_address": null
    },
    "code": 0,
    "message": "Success"
}

Modified at 2026-11-09 12:08:31

Qr Sign/Identification process

sign-in