The EyeQuant API handles errors in two ways:

  • HTTP status codes – Whenever an error directly relates to a HTTP request, we return an appropriate status. A code in the 400 to 499 range indicates an error than can be resolved by the client, whereas codes 500 to 599 indicate errors on the server-side.
  • Structured information in the JSON response body – Where possible, we also include a textual error code and a specific error message in the JSON response.

Example error:

HTTP/1.1 401 Unauthorized

  "error": {
    "code": "authentication_failed",
    "message": "We were unable to authenticate you. Please check your credentials."

A list of common errors – concrete errors may contain more information in the message field:




Generic client error. Something is wrong with the request.


Generic server error. There's been an error in our system. We have been alerted about this and are probably already looking into it.


The resource under the requested URL is no longer accessible. See Result expiry.


Missing or incorrect API credentials. Please check your API key.


The service is currently unavailable. See API Status for up-to-date status information.


We could not start an analysis based the provided input object. The error message should contain more detailed information.


We attempted to fetch the web page specified in the input, but were unable to capture it. This could be due to a number of issues, including: an error in the URL, the web page timing out, or an error during rendering. To work around this issue, re-try the analysis or use an image input instead.


The input image is completely blank – a single, solid color. Unfortunately, we cannot make meaningful predictions on such images.


We were unable to read the input image, either because the format is not supported, or because the image is truncated or corrupted. See Image formats and limitations for supported formats.


The dimensions of the input image are either too small or too large. See Image formats and limitations for dimension limits.