Errors

Errors use one JSON envelope.

All API errors return an error object with a stable code and human-readable message.

Shape

{
  "error": {
    "code": "validation_error",
    "message": "limit must be 5000 or less",
    "request_id": "optional-request-id"
  }
}

Common statuses

StatusCodeMeaning
400validation_errorA query parameter or host value is invalid.
401missing_auth or bad_authThe API key is missing or invalid.
403forbiddenThe API key exists but is not assigned to the required API group.
404not_foundThe requested host was not found in the selected window.
405method_not_allowedThe endpoint does not support that HTTP method.
500internal_errorThe API could not complete the request.