Errors And Request IDs

Error Envelope

All Public API errors return a consistent envelope:

{
  "error": {
    "code": "invalid_request",
    "message": "quantity must be greater than zero",
    "request_id": "req_...",
    "details": []
  }
}

Error Codes

Baseline codes in v1:

• invalid_request (400)
• unauthorized (401)
• forbidden (403)
• not_found (404)
• conflict (409)
• internal_error (500)

Request IDs

Every response includes:

• X-Request-Id response header
• error.request_id in error bodies

If you need support, include the request id in your message.