Errors

Errors use standard HTTP status codes and a consistent JSON body with a machine-readable code.

{
  "error": {
    "code": "BAD_DATE",
    "message": "pay_date must be YYYY-MM-DD",
    "request_id": "req_Q1w2E3r4T5y6",
    "docs_url": "https://…/docs/errors#bad_date"
  }
}

Branch on error.code, not on the message — messages may be reworded. Codes are stable within an API version.

Retrying

Retry 429 and 5xx responses with exponential backoff and jitter. Don't retry other 4xx responses; they won't succeed without a change. All endpoints are read-only, so retries are always safe.

Error codes