HTTP response codes

The HTTP response code tells your application whether the API could process your request.

The codes are grouped into ranges. For a simple error handling strategy it's often sufficient to only test the first character.

  • 200-299: Success. The server has done what the client requested.
  • 400-499: Client Errors. Generally the client must ammend the request.
  • 500-599: Server Errors. The server has a problem that is not related to the request.

Success Codes (2xx)

HTTP Status Code Error Message Description
200 OK The API was able to do what you asked.

Client Errors (4xx)

HTTP Status Code Error Message Description
400 Bad Request The API could not understand your request.
401 Unauthorized The access token was missing or invalid.
403 Forbidden You have not been granted permission to access the requested method or object.
403 Not Authorized The API key associated with your request was not recognized or the signature was incorrect.
403 Account Inactive The API key you are using has not been approved or has been disabled.
403 Account Over Queries Per Second Limit You have made too many calls per second with this API key.
403 Account Over Rate Limit You have exceeded the rate limit for this API key.
403 Rate Limit Exceeded The service you have requested is over-capacity.
404 Not Found The API does not have the resource that you asked for.
405 Not Allowed You have used a method (e.g. PUT) that isn’t supported for this resource.

Server Errors (5xx)

HTTP Status Code Error Message Description
500 Internal Server Error Something has gone terribly wrong, but it's not your fault. Try again later.