Skip to main content

Error response

HTTP 2xx means the request was accepted or returned successfully, not that a Job succeeded. 4xx indicates an input, authentication, access, state or limit problem. 5xx indicates a service or execution failure.
Job and item failures include an error object with error_code and detail. Check the Job’s status even when the request returns HTTP 200: the Job can still have status: "failed".

Error codes

Retry rules

  • Fix invalid parameters before retrying validation_error.
  • Replace or rotate the key for unauthenticated; check permissions for forbidden.
  • Reuse the same Idempotency-Key and unchanged body when a start request fails with a retryable error.
  • Use a new key for a deliberately different request after idempotency_key_reused.
  • Follow Retry-After when retryable is true. If retries continue to fail, contact support with the request ID.
  • For items_not_available, wait if the Job is still running. If it has finished, check its result for files or contact support. Do not restart paid research automatically.
For older route errors, see Legacy Errors.