Error Codes Reference
Leaderboards and Tournaments API requests may result in an error response from the Leaderboards and Tournaments service. Each error response includes an error code to indicate the specific type of error. The following example shows the fields in the message body of an error response:
{
"errorCode": 207,
"message": "Players has no more remaining attempts, cannot enter provided 'matchId'.",
"request_id": "20de6268-31b3-4bea-beea-9c9c8b594fc5"
}
Field | Description |
---|---|
errorCode | A unique number to identify the specific error. |
message | A description of the error. See note below. |
request_id | The request ID that resulted in the error response. If you need support, share the request ID with Leaderboards and Tournaments support to help identify the specific request that caused the error. |
Note: Error code values will not change, so you can check for specific values in your game software. The text in the error messages may be updated over time (for increased clarity or utility), so do not create any dependency between your game software and the specific text content of any message fields.
The table below contains the full list of error codes. The Leaderboards and Tournaments API references list the specific error codes that can be returned by each API request.
Error Code | HTTP Code | Error Description |
---|---|---|
0 | 500 | An unknown error has occurred. If this error persists, please contact Leaderboards and Tournaments support. |
1 | [401, 403] | Invalid x-api-key. Provide a valid API Key in the x-api-key header. |
2 | 401 | Invalid or expired session-id. Provide a valid Session ID in the session-id header. |
3 | 400 | One or more validation errors occurred: 'list of errors'. |
4 | 400 | Unable to parse the request body. Verify the syntax is valid JSON and try again. |
5 | 400 | Missing or invalid 'content-type'. Provide a valid content type of application/json in the content-type header. |
6 | 400 | Missing or invalid required headers/parameters. Provide the missing header/parameter. |
7 | 400 | Method 'this method' is not supported on this endpoint. Supported methods include: 'list of supported methods'. |
8 | 429 | Too many requests are sent. |
9 | 404 | The provided 'gameId' was not found. |
10 | 500 | An error has occurred while calling a dependent service. |
11 | 403 | The player has been banned by the tournament creator and cannot take this action. If you feel the player was banned by mistake, please contact support. |
100 | 400 | The provided 'encryptedPayload' could not be decrypted. Ensure the payload is encrypted with the Game Public Key provided upon registration. |
101 | 400 | Missing 'encryptedPayload'. Ensure the payload is encrypted with the Game Public Key provided upon registration. |
102 | 400 | The provided 'encryptedPayload' was decrypted successfully, however the contents of the payload did not consist of a valid Public Key. Verify that the payload is a valid Public Key before encrypting with the Game Public Key. |
103 | 400 | The provided 'encryptedPayload' was decrypted successfully, the contents of the payload consisted of a valid Public Key, however the size of the key was not at least 2048 bits in size. |
104 | 400 | The provided 'encryptedPayload' could not be decrypted or the contents did not consist of a valid Public Key. Ensure the payload is encrypted with the Game Public Key provided upon registration. |
105 | 401 | A player with the provided 'playerToken' could not be found. |
106 | 400 | The provided 'playerToken' is invalid. Ensure that the token is a valid UUID. |
107 | 403 | The player has been banned and cannot take this action. If you feel the player was banned by mistake, please contact support. |
108 | 404 | A player with the provided 'externalPlayerId' could not be found. |
109 | 401 | A session with the provided 'sessionId' could not be found. |
110 | 401 | The session for the provided 'sessionId' has expired. Please re-authenticate the player for a new session. |
111 | 401 | Invalid x-api-key or externalGameId. Provide a valid API Key in the x-api-key header, or a valid externalGameId in the path. |
200 | 404 | The tournament with the provided 'tournamentId' could not be found. |
201 | 404 | The match with the provided 'matchId' could not be found. |
202 | 404 | The player with the provided 'playerId' could not be found in the provided 'matchId'. |
203 | 409 | Maximum number of attempts has been exceeded. |
204 | 409 | Cannot perform action on provided 'tournamentId' because it has already started. |
205 | 409 | Cannot perform action on provided 'tournamentId' because it has already completed. |
206 | 409 | Cannot enter the tournament before it has started. |
207 | 409 | Players has no more remaining attempts, cannot enter provided 'matchId'. |
208 | 409 | The player does not meet the requirement(s) to enter, based off the 'playerAttributes' provided. |
209 | 409 | Cannot enter the tournament because the player has not linked with a streaming platform account. |
210 | 409 | The player with the provided 'sessionId' did not use an access key for a tournament that requires it. |
211 | 409 | The player with the provided 'sessionId' used an access key that does not match the tournament's access key. |
212 | 409 | The provided 'teamId' does not meet the size requirements of the tournament. The tournament requires a team size between 'minimum team size' and 'maximum team size'; The provided 'teamId' has a max size of 'team size'. |
213 | 409 | There are no available matches to enter for the provided 'tournamentId'. |
214 | 409 | Cannot remove the team from the tournament if the tournament is not in the 'OPEN' or 'CLOSED' state. |
215 | 404 | The provided 'tournamentId' is not a 'creator type' tournament. |
216 | 409 | Player with provided 'sessionId' does not have the required permissions to update the provided 'tournamentId'. |
217 | 409 | Cannot close a tournament that has not started. |
218 | 409 | The provided 'tournamentId' has been completed and cannot be closed again. |
219 | 409 | The provided 'tournamentId' is currently being processed. Please wait before attempting to close the tournament again. |
220 | 404 | The provided 'teamId' was not found in the provided 'sessionId' and 'tournamentId'. |
221 | 404 | Cannot enter the tournament because it is full. |
222 | 404 | Cannot enter the tournament after it has ended. |
223 | 403 | The provided sessionId is not valid for this resource. |
224 | 404 | Player has joined maximum number of matches, allowed per player, for this tournament. |
225 | 409 | All prizes have been claimed. |
300 | 404 | The provided 'prizeIds' are not found. |
400 | 404 | The provided 'requirementIds' are not found. |
801 | 404 | The player with the provided 'sessionId' is not in the provided 'teamId'. |
802 | 404 | The provided 'teamId' could not be found. |