Handling errors

When using our API, it is crucial to anticipate and handle errors effectively. To aid in this process, our API utilizes a standardized format for returning error messages. These error responses provide detailed information on the nature of the error, by adhering to this format, developers can easily identify and resolve issues when they arise, improving the overall reliability and efficiency of the API integration.

Errors in responses

Rated API’s errors will always be returned as JSON

Errors will always come in a dictionary containing a detail key and its value can be either a list of dictionaries or a string describing the error message.

400 Bad Request

{
  "detail": [
    {
      "loc": ["body", "email"],
      "msg": "value is not a valid email address",
      "type": "value_error.email",
    }
  ]
}

{
  "detail": [
    {
      "loc": [
        "query",
        "pubkeys",
        0
      ],
      "msg": "Invalid public key",
      "type": "value_error"
    }
  ]
}

401 Unauthorized

No token given
Invalid token
Expired token
Unknown token

{"detail": "Not authenticated"}

Reason: You forgot to send the Authorization header with a Bearer token.

{"detail": "Could not validate access token."}

Reason: The token you are using is not from us. You need to get and use valid token.

{"detail": "Expired token."}

Reason: Self-explanatory, you need to get a new token at console.rated.network/apiKeys.

{"detail": "Unknown token."}

Reason: The token might be valid before but we don’t know it anymore. Most likely, it was invalidated after a password reset.

403 Forbidden

{"detail": "You don't have permission to do that."}

Reason: The token you are using does not have enough permission to perform the request.

404 Not Found

{"detail": "Not found."}

Reason: The resource you requested was not found. Double check the API Reference.

429 Too many requests

{"detail": "Too many requests"}

Reason: You have hit too quick too many times the API. Back-off and retry later.

500, 502, 504 Server errors

{"detail": "Internal server error."}

Reason: Something went wrong on our side, these are rare. In case you need assistance contact us and provide the Request ID and we will gladly help you.

Getting started

Rated API

Endpoints

Glossary

Guides

Tools

Errors in responses

400 Bad Request

401 Unauthorized

403 Forbidden

404 Not Found

429 Too many requests

500, 502, 504 Server errors