Sign in
extract

Extract structured data from multiple documents

Changed on

Admit up to 100 file-backed extract child jobs in one durable batch. Every item uses file_index or file_id; parse_job_id reuse is single-extract-only and is not accepted in batch. Partial child failures are preserved. Parent status derivation follows JobStatus; billing is evaluated per child.

post/extract/batch

Request

  • Base URL: https://api.openparser.dev
  • URL: https://api.openparser.dev/extract/batch
  • Auth: HTTP bearer

Headers

Idempotency-Keystring required

Client-supplied idempotency key. Required on every parse or extract POST. Must be unique per distinct request body for a given tenant and operation.

Response

Durable batch job admitted. Location points at the parent batch job resource.

idstring required

Prefixed public id for an OCR job (opj_…).

operation'parse_batch' | 'extract_batch' required
status'queued' | 'running' | 'succeeded' | 'failed' | 'indeterminate' required

Durable job status. For batch parent jobs, status is derived from children after each child transition:

  1. If any child is non-terminal, the parent remains queued only while every child is queued; it becomes running once any child is running or terminal.
  2. When every child is terminal and any child is indeterminate, the parent is indeterminate.
  3. When every child is terminal, none are indeterminate, and any child is failed: the parent is failed if zero children succeeded, otherwise succeeded (mixed success/failure closes as parent succeeded while preserving failed children in summaries).
  4. When every child is succeeded, the parent is succeeded.

Partial failures are always retained on child summaries; parent status does not drop failed children from results.

output_format'openparser@1' | 'raw' required
created_atstring date-time required
updated_atstring date-time required
child_countinteger required

Example response

{
  "id": "opj_V1StGXR8_Z5jdHi6B-myT"
}

Changes

  • 4561194517a8Revision changes
    • breaking

      added 'propertyNames' constraint to the request property ///

    • warning

      removed the request property ////

    • warning

      removed the request property ////

    • warning

      removed the request property ////