Skip to main content
GET
Python

Path Parameters

job_id
string
required

The identifier of the job to retrieve, as returned by the create-job request.

Response

Job status / result

job_id
string

The unique identifier for this v2-extract job. Format: extract-<26-character Crockford base32 ULID> ([0-9a-hjkmnp-tv-z]{26} tail). 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>
Available options:
pending,
processing,
completed,
failed
created_at
string | null
completed_at
string

Present once the job is terminal.

progress
number

Estimated completion as a decimal from 0 to 1 — an estimate, not a measurement: it typically advances between polls while the job is processing, may jump forward when the service reports a real milestone (e.g. parsed pages), and approaches but never reaches 1 (long-running jobs plateau near 0.98 — completion is signaled by status, and a job may complete from any progress value). Present while processing.

Required range: 0 <= x <= 1
result
V2ExtractResult · object | null

Present once status is completed and output_save_url was not set. When output_save_url was set, the result is delivered there and output_url is returned instead.

error
object

Present once status is failed.

output_url
string | null

The URL the result was delivered to. Present once the job has completed and output_save_url was set, instead of inline result.

metadata
object | null

The result's metadata block (billing included), present alongside output_url once a job with output_save_url has completed — the delivery moves the content, not the receipt. Same shape as the inline result's metadata; inline jobs carry it there instead.