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.

Last updated