Skip to main content
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. 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. Idempotency: POST /v1/parse takes an Idempotency-Key header. See Jobs. 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.