API overview
Find OpenParser endpoints and common response codes.
For interactive endpoint documentation, request and response schemas, and the API playground, see the full API reference.
Production base URL:
https://api.openparser.devAuthentication
Create an API key in OpenParser Studio, then send it with every request:
Authorization: Bearer YOUR_API_KEYKeep API keys in a secret manager or server-side environment variable. Never include them in browser code or source control. A missing or invalid key returns 401 Unauthorized.
The key determines the organization for the request. You don't send a tenant or organization parameter. Jobs, reusable files, and pipelines belong to that organization. Referencing a resource from another organization returns 404 Not Found, just like an unknown ID.
Rate and concurrency limits apply across the organization, not separately to each key. If you receive 429 Too Many Requests, wait for the number of seconds in Retry-After before trying again.
Model discovery
Hosted OCR and LLM catalogs are exposed at GET /models/ocr and GET /models/llm. See Model catalogs for discovery, pricing fields, and SDK typed helpers (HOSTED_OCR_MODEL_IDS, HostedOcrOptionsFor, hostedParseRequest, and Python equivalents). Those ids and option types are SDK/API surface — not part of @openparser/schema or @openparser/adapters.
Idempotency
An Idempotency-Key of 1–256 characters is required on:
POST /parse,/parse/async, and/parse/batchPOST /extract,/extract/async, and/extract/batch
It is not required on helper, file, or pipeline operations that do not admit jobs.