In case of error responses the Xsolla Login server returns a JSON object with the following fields:

Field Type Description
code string Xsolla Login server error code.
description string Error description. The text is always in English. Do not use this text in case of an error, as the value can change in the future.
  "error": {
    "code": "000-000",
    "description": "description"

400 Bad Request

Code Description
0 Request has invalid parameters.
010-019 Client authentication failed (e.g. unknown client, no client authentication included, or unsupported authentication method).
010-022 Parameter state missing or too weak as it has less than 8 characters.
010-023 Authorization grant or refresh token is invalid, expired, revoked, doesn’t match the redirection URI used in authorization request, or issued for another client.

401 Unauthorized

Code Description
002-016 Invalid token.
002-040 Unable to authorize banned user.
003-001 Wrong username or password.
003-007 User account not confirmed.
003-025 Error occurred while getting OAuth 2.0 access token.
003-040 Unauthorized user.
010-026 Xsolla Login server or resource owner denied request.

403 Forbidden

Code Description
1901-0001 Invalid token.

404 Not Found

Code Description
003-002 User not found.
003-019 Project not found.
003-061 Object not found.

418 I’m a teapot

Code Description
004-001 Something went wrong.

422 Unprocessable Entity

Code Description
0 Nickname missed in query.
002-050 User’s two-factor authentication settings not changed.
003-003 User with specified username already exists.
003-020 Call unavailable for this Login project.
003-022 This Login project misconfigured. Change this Login project settings in Xsolla Publisher Account or contact your Account Manager.
003-033 Mismatch project type.
006-003 OAuth 2.0 clients with client_credentials grant type only can have access list.
010-015 Social network authentication failed: SERVICE_NAME.
010-016 This social account already linked to another user.
010-032 Authentication via this social network not enabled for this Login project. Enable it in your Xsolla Publisher Account > Login > your Login project > Social connections.
030-024 Password reset disabled for this Login project.
2002-0001 Duplicated attributes.

429 Too Many Requests

Code Description
002-054 Allowed number of search attempts exceeded. Wait one second before next request.
010-005 Allowed number of requests exceeded.
1900-0001 Allowed number of requests exceeded.