Parse multiple documents in one batch
Admit up to 100 parse child jobs in one durable batch. Every uploaded file must be mapped
exactly once by file_index. Partial child failures are preserved in batch results.
Parent status derivation for mixed outcomes is defined on JobStatus.
Authorization
bearerAuth Existing Eigenpal API key presented as a bearer token.
In: header
Header Parameters
Client-supplied idempotency key. Required on every parse or extract POST. Must be unique per distinct
request body for a given tenant and operation.
1 <= length <= 256Request Body
multipart/form-data
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/parse/batch" \ -H "Idempotency-Key: 7f9f2f3d-0f8a-4f0a-9a2b-2f6f0a7d2c11" \ -H "Authorization: Bearer $OPENPARSER_API_KEY" \ -F request="{ \"items\": [ { \"client_item_id\": \"string\", \"ocr_model\": \"string\" } ] }"{ "id": "opj_b2c3d4e56f7a8901bcdef23456789012", "operation": "parse_batch", "status": "queued", "output_format": "openparser@1", "created_at": "2026-07-17T12:00:00Z", "updated_at": "2026-07-17T12:00:00Z", "child_count": 2}{ "error": { "code": "malformed_request", "message": "multipart field `request` is not valid JSON", "request_id": "req_01h2example", "retryable": false }}{ "error": { "code": "unauthorized", "message": "invalid API key", "request_id": "req_01h2example", "retryable": false }}{ "error": { "code": "insufficient_credits", "message": "tenant has insufficient credits for admission", "request_id": "req_01h2example", "retryable": false }}{ "error": { "code": "forbidden", "message": "API key lacks required scope", "request_id": "req_01h2example", "retryable": false }}{ "error": { "code": "idempotency_conflict", "message": "Idempotency-Key was already used with a different request body", "request_id": "req_01h2example", "retryable": false }}{ "error": { "code": "limit_exceeded", "message": "source exceeds 50 MiB admission limit", "request_id": "req_01h2example", "retryable": false, "details": { "limit": "max_input_bytes", "max_value": 52428800 } }}{ "error": { "code": "unsupported_media_type", "message": "only PDF, PNG, and JPEG uploads are accepted", "request_id": "req_01h2example", "retryable": false }}{ "error": { "code": "unsupported_ocr_model", "message": "unknown OCR model registry name", "request_id": "req_01h2example", "retryable": false, "details": { "ocr_model": "paddleocr-vl-9.9" } }}{ "error": { "code": "rate_limited", "message": "request rate limit exceeded", "request_id": "req_01h2example", "retryable": true }}{ "error": { "code": "source_upload_failed", "message": "source upload failed", "request_id": "req_01h2example", "retryable": true }}Parse a document asynchronously POST
Admit a durable parse job and return immediately. Example (`multipart/form-data`): ```bash curl -X POST 'https://api.openparser.dev/parse/async' \ -H 'Authorization: Bearer YOUR_API_KEY' \ -H "Idempotency-Key: $(uuidgen 2>/dev/null || openssl rand -hex 16)" \ -F 'request={"ocr_model":"paddleocr-vl-1.6","output_format":"openparser@1"};type=application/json' \ -F 'file=@./document.pdf' ```
Extract structured data synchronously POST
Admit a single extract job from file bytes, `file_id`, or a tenant-owned succeeded `parse_job_id`, then run schema-constrained OpenRouter extraction via `llm_model`. A `parse_job_id` source reuses the canonical ParsedDocument (from dual artifacts or legacy `result_json`) without OCR or another page charge; historical raw-only parses return `422 canonical_result_unavailable`. Wait up to the sync wait limit and return `ExtractionTerminalResult` when ready. Terminal `failed` within the wait window returns `422`; terminal `indeterminate` returns `504`. Returns `202` with a durable job reference and `Location` if the wait expires.