Concepts

Errors

One error format for every endpoint, stable codes you can branch on, and a request ID for support.

Errors use normal HTTP statuses and always the same body. Branch on code — it never changes; message is for people and may be reworded.

json

{
  "error": {
    "code": "ITEM_UNAVAILABLE",
    "message": "Paneer Tikka is not available right now.",
    "field": "items[2]",
    "requestId": "req_7Hc2…"
  }
}

The full list of codes is in the Error codes table below the API reference (search “errors”).