Error Codes & Responses

HTTP Status Codes

The API will attempt to return the following HTTP status codes for every request:

  • 200 OK: Success
  • 304 Not Modified: There is no new data to return.
  • 400 Bad Request: The request is invalid.
  • 401 Unauthorized: Authentication credentials are missing or incorrect.
  • 403 Forbidden: The request is understood, but is refused.
  • 404 Not Found: The resource requested, such as a user, does not exist.
  • 406 Not Acceptable: Returned when an invalid format is specified in the request.
  • 420 Rate Limited: Returned by the API when you are rate limited.
  • 500 Internal Server Error: Something is broke. Please contact an administrator.
  • 502 Bad Gateway: The API is down.
  • 503 Service Unavailable: The API servers are up, but are unavailable.
  • 504 Gateway Timeout: The API servers are up, but did not receive a timely response.