Errors

Semantics around error messages that you might stumble upon when working with the Rated API.

Rated API utilizes standard HTTP response codes to communicate the outcome of an API request. It is essential to note that:

• Response codes in the 2xx range signify successful execution of the request.

• Response codes in the 4xx range indicate a client-side error, arising from insufficient or incorrect information provided (e.g., missing required parameters, invalid values types, etc.).

• Response codes in the 5xx range signify a server-side error, indicative of an issue with Rated's servers. These are uncommon.

HTTP status code summary

HTTP Code
200 Ok	Everything worked as expected.
400 Bad Request	The request was unacceptable, often due to a missing required parameter or an invalid value type.
401 Unauthorized	No valid bearer token provided.
403 Forbidden	The bearer token doesn't have permissions to perform the request.
404 Not Found	The requested resource doesn't exist.
429 Too Many Requests	The number of requests to the Rated API is too high. Back-off and try again later.
500, 502, 503 Server Errors	Something failed on our servers.