Errors

The API uses standard HTTP status codes. A 2xx means success; 4xx means the request needs changing; 5xx means something went wrong on our side. Error responses carry a JSON body with a human-readable message.

HTTP/1.1 422 Unprocessable Entity
Content-Type: application/json

{ "detail": "shipping_address.postal_code is required" }

Status codes

Code	Meaning
`400`	Bad request — malformed or missing input.
`401`	Unauthenticated — missing, invalid or expired token.
`403`	Forbidden — the token isn't allowed to access this resource.
`404`	Not found — no such resource, or it isn't in your shop.
`409`	Conflict — the request clashes with the current state.
`422`	Validation error — the body failed validation.
`429`	Rate limited — slow down and retry.
`5xx`	Server error — retry with backoff; contact us if it persists.