Error codes

Common error codes in API usage

We hope you never get an error using our API. But if you do, this page will help you understand what went wrong.

We use all status codes according to the http protocol specification.

The best status code of all is:

200 - Successful Request

If you do see errors, here are the most common ones:

Error CodeTitleDescription
400Bad RequestThe server cannot or will not process the request due to a client error, such as invalid syntax or missing required parameters.
401UnauthorizedThe request requires user authentication, but the user has not provided valid credentials or does not have permission to access the requested resource.
403ForbiddenThe user is authenticated but cannot access the requested resource.
404Not FoundThe requested resource could not be found. This can happen if the URL is incorrect, the resource has been deleted, or the server cannot access the resource.
405Method Not AllowedThe requested method is not allowed for the resource. For example, using a POST request on a resource that only accepts GET requests.
429Too Many RequestsThe user has sent too many requests in a given amount of time. The server indicates that the client should wait before sending more requests.
500Internal Server ErrorThe server encountered an unexpected error and could not complete the request. This could be due to a bug in the server code or a problem with the server's configuration.
503Service UnavailableThe server cannot handle the request due to maintenance, overloading, or other temporary reasons.