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 Code


200 – OK

Everything is okay, the response contains the requested information.

400 – Bad request

The request parameter contains invalid characters (e.g. domains)

401 – Unauthorized

You did not provide a valid API key; see Authentication.

403 – Forbidden

The requested information can not be accessed.

429 – Too many requests

You reached your quota or rate limit; see Quotas & Rate Limits.

500 – Internal Server Error

An internal error occurred. In case the error persists, please contact our support.