Skip to main content
POST
Python

Body

multipart/form-data
document
file

The file to parse. The file must be a PDF or image; see the list of supported file types. Provide either document or document_url, not both.

document_url
string

A publicly accessible URL to the file to parse. The file must be a PDF or image; see the list of supported file types. Provide either document or document_url, not both.

model
string

The DPT-3 model snapshot to use for this request. Accepts a dated snapshot (for example, dpt-3-pro-20260710), the dpt-3-pro-latest alias, or the bare dpt-3-pro family name (equivalent to dpt-3-pro-latest). Defaults to the latest DPT-3 Pro snapshot.

options
ParseOptions · object

Optional object that customizes the parse. Use it to select which pages to process, adjust how content appears in the Markdown, or control how much detail the response includes. Sent as a JSON-serialized string in form data.

output_save_url
string

Public URL the full response is delivered to; the API response then carries output_url instead of inline data.

service_tier
enum<string>

Async service tier (POST /jobs only). priority runs in the fast lane at the sync billing rate; absent → standard.

Available options:
standard,
priority

Response

Job created

job_id
string
required

The unique identifier for the created parse job. Poll GET /v2/parse/jobs/{job_id} for its status and result. Format: <service>-<26-character Crockford base32 ULID> matching ^(parse|extract)-[0-9a-hjkmnp-tv-z]{26}$. Opaque, server-minted, and stable for the life of the job — the same id is returned on the sync response, the async 202, and every poll. Treat it as opaque; older id formats remain accepted indefinitely and are never re-issued.

status
enum<string>
required

The job's status at creation — normally pending (a just-created job that is still running is reported as pending), but may already be a terminal completed / failed if the job finished before the create response was rendered.

Available options:
pending,
processing,
completed,
failed
created_at
string | null
required

ISO-8601 timestamp for when the job was created.