Skip to main content
A request that works gets 200. Anything else is an error, and an error costs no credits.

The error body

400 answers, and 404 for a job, are JSON:
  • errors lists every problem, not only the first.
  • path says which param is wrong: where it is (query or params) and its name.
  • code is 7001 for a bad param and 7002 for not found.
  • Read message to fix your request, but do not match on its text in code; it may change. Match on the status and code.
401, 402, 403 and 429 answers are JSON with one error message, for example {"error": "Missing or unknown API key"}. A 401 also has a WWW-Authenticate: Bearer header. A path that does not exist gets a plain-text 404.

Retries

Retry 5xx answers, with a growing wait between tries. Retry 429 after its Retry-After. Do not retry 400, 401, 402, 403 or 404; they will fail again.