Error codes

This documentation provides a comprehensive list of HTTP status codes that may be returned by our API, indicating the outcome of an API request.

Client Errors (4xx)

• 400 Bad Request

  • The request could not be understood by the server due to malformed syntax.

• 401 Unauthorized

  • The request requires user authentication or the authentication failed.

• 403 Forbidden

  • The server understood the request, but is refusing to fulfill it.

• 404 Not Found

  • The server has not found anything matching the Request-URI.

• 405 Method Not Allowed

  • The method specified in the Request-Line is not allowed for the resource identified by the Request-URI.

• 422 Unprocessable Entity

  • The request was well-formed but was unable to be followed due to semantic errors. This is typically used for validation errors.

• 429 Too Many Requests

  • The user has sent too many requests in a given amount of time ("rate limiting").

Server Errors (5xx)

• 500 Internal Server Error

  • The server encountered an unexpected condition which prevented it from fulfilling the request.

• 503 Service Unavailable

  • The server is currently unable to handle the request due to a temporary overloading or maintenance of the server.