Developer Console

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.

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.