We use HTTP response codes to indicate success or failure of a request. In general errors can be grouped as follows

  • 2xx Success
  • 4xx Client error (e.g. not all required parameters provided)
  • 5xx Server error (these are rare, contact our support if such errors persist)

HTTP Status Code Summary

Status CodeDescription
200 – OKEverything is okay, the response contains the requested information.
400 – Bad requestThe request parameter contains invalid characters (e.g. domains)
401 – UnauthorizedYou did not provide a valid API key; see Authentication.
403 – ForbiddenThe requested information can not be accessed.
429 – Too many requestsYou reached your quota or rate limit; see Quotas & Rate Limits.
500 – Internal Server ErrorAn internal error occurred. In case the error persists, please contact our support.