Errors & limits

Use the HTTP status and response code to decide what to do next.

JSON

{
  "error": "Store request limit exceeded",
  "code": "RATE_LIMITED"
}

HTTP responses

Status	What to do
`400`	Correct the JSON, input fields, or pagination. Validation errors may include details.
`401 / 403`	Check the live API key and whether the store has API access enabled.
`404`	Check the ID. Jobs and quotes must belong to the authenticated store.
`409`	Read code for an expired or used quote, idempotency conflict, or changed job state.
`422`	Check available credit, route coordinates, and the supported delivery area.
`429`	Wait the number of seconds in Retry-After before retrying.
`500 / 503`	Retry later. For an uncertain booking, reuse its key and payload.

Limits apply per store across all of its API keys.