Skip to main content
Error bodies are { "error": "<message>" }. Errors your integration should act on also carry a stable code, and some carry extra fields. Branch on code, never on the message text.

Status codes

The errors every endpoint can return before it does anything else (401, 403, 429, 503) are listed on Authentication and keys.

Every code

Errors without a code

A 400 without a code is a malformed request (an unknown category on the catalog, a kind other than sellback on a quote, a status other than shipped or delivered on the sandbox shipment endpoint). Every unknown order, token, quote, shipment, payment or webhook id answers 404 with its UNKNOWN_* code. A 500 body says Something went wrong; retry with the same Idempotency-Key. Retry with backoff.