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


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.

Last updated