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

# API reference

> The complete Formitto API — every endpoint, parameter, and response.

This reference is generated from our OpenAPI 3.1 specification, so it always
matches the live API. Each endpoint below has its own page with parameters,
request bodies, response schemas, and a request playground.

## Conventions

* **Base URL:** `https://formitto.com/v1`
* **Auth:** `Authorization: Bearer fmt_live_...` (see [Authentication](/authentication))
* **Lists** return `{ data, pagination }`; single resources return the object directly.
* **Pagination:** `page` (1-based) and `limit` (default 25, max 100).
* **Rate limits:** 1000 requests/hour per key; read `X-RateLimit-*` headers, back off on `429`.

## Errors

Every error uses a consistent shape with a stable machine-readable `code`:

```json theme={null}
{ "error": "Human-readable message", "code": "stable_code" }
```

Common codes: `invalid_api_key` (401), `insufficient_scope` (403),
`not_found` (404), `rate_limited` (429), plus request-specific codes like
`domain_required` and `forbidden_field` (400).

Browse the endpoints in the sidebar, or start with the
[getting-started guide](/getting-started).