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

# API reference

> Base URL, authentication, errors and conventions for every endpoint.

**Base URL**: `https://api.parser-app.com`. Every endpoint is under `/v1`, except the health checks.

**Authentication**: an API key in `X-API-Key`, or an API key or AuthKit access token as
`Authorization: Bearer`. Each endpoint lists the permission it needs. See [Authentication](/authentication).

**Requests**: JSON bodies, except `POST /v1/parse` (multipart files) and `POST /v1/intake/email` (a raw
`message/rfc822` email). Dates are ISO 8601.

**Errors**: `{"error": {"code", "message", "request_id"}}`, with the request id also in `X-Request-ID`. See the
[status codes](/authentication#errors).

**Idempotency**: `POST /v1/parse` takes an `Idempotency-Key` header. See [Jobs](/concepts/jobs#idempotency).

**Paging**: `GET /v1/jobs`, `GET /v1/mailboxes/{id}/messages` and `GET /v1/audit-log` take `limit` and `cursor`,
and answer `next_cursor` (null on the last page).

**Rate limits**: writes 120 a minute per key and 600 per tenant; beyond them `429` with `Retry-After`.

The full OpenAPI document is at [`/openapi.json`](/openapi.json).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.