> ## Documentation Index
> Fetch the complete documentation index at: https://docs.intention.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Errors

> The error model and error codes returned by the Intention API.

Intention's API returns structured error responses with stable codes that clients can branch on. This page will document the error model — the response shape, the error code namespace, and the categories used by REST, WebSocket, and integration endpoints.

<Note>
  Status: not yet published. The error code list will be finalized alongside the first stable API release. Treat the descriptions below as planning documentation.
</Note>

## What this page will contain

* **Response shape.** The canonical JSON structure of an error response on REST and WebSocket.
* **Categories.** Validation errors, signing errors, sequencing errors, rate-limit errors, market-state errors, and protocol-level errors.
* **Stable codes.** The full list of error codes, each with a short description and a pointer to the relevant policy or convention page.
* **Retryability.** Which errors are retryable, which are not, and how to back off safely after a `429` or a transient `503`.
* **Cross-references.** How errors interact with [nonces](/api-reference/conventions/nonces), [signing](/api-reference/conventions/signing), [tick and lot](/api-reference/conventions/tick-lot), and [rate limits](/api-reference/conventions/rate-limits).

For early integration questions, email `contact@intention.xyz`.