Docs · Operations

Errors

Predictable status codes. Structured error bodies.

Status codes

200 OK

201 Created · synchronous response

202 Accepted · job queued

401 Unauthorized · signature / key invalid

402 Payment Required · active subscription required

403 Forbidden · IP not allowed

404 Not Found · listing or account unknown

409 Conflict · identical request already in progress

422 Unprocessable Entity · validation failed

429 Too Many Requests · rate-limited

502 Bad Gateway · upstream error

503 Service Unavailable · retryable upstream error

Error body shape

error body

{
  "error": {
    "code": "upstream_error",
    "message": "Upstream error. Please retry later."
  }
}

Validation failures (422 validation_failed) additionally include a details object with field-level messages. Every response also carries an X-Request-ID header — include it when contacting support.