Errors

If the API responses with 200 then it is a good response. Anything else contains an error.

The Clash Royale API uses the following error codes:

Error CodeMeaning
400Bad Request -- Your request sucks.
401Unauthorized -- No authentication was provided, or key invalid.
404Not Found -- The specified player / clan cannot be found. Could be invalid tags.
417Expectation Failed -- Clan not tracked.
429Too Many Requests -- You have hit the API Ratelimit. More info
500Internal Server Error -- We had a problem with our server. Try again later.
501Not Implemented Yet -- We have yet to implement this feature in v3 of the API.
503Service Unavailable -- We're temporarily offline for maintenance. Please try again later.
522Service Unavailable -- We're temporarily offline. Please try again later.

Error response

All the error responses come in this format:

{
    "error": true,
    "status": 404,
    "message": "Not found | Additional information and support: https://discord.me/RoyaleAPI"
}
FieldDescription
errorBoolean – will always be true if it is an error.
statusThe error code
messageA human readable message explaining the error.
Last Updated:
Contributors: SML, Ni, fourjr, fourjr