public-api

Parse Sync

Parse a document and wait for the result (small documents; use /parse_async for large ones).

post/api/v1/parse

Request

Query parameters

timeout_secondsnumber

Max seconds to wait before returning 408 (the job keeps running; poll GET /jobs/{job_id}).

Request body

idempotency_keystring nullable

Repeating a POST with the same key returns the original job instead of starting a new one.

Response

Successful Response

job_idstring uuid required
actionstring required

One of parse/ground/categorize/extract.

statusstring required

One of pending/running/succeeded/failed.

is_exampleboolean

True for provisioned Playground example jobs.

created_atstring date-time required
started_atstring date-time nullable
completed_atstring date-time nullable
credits_usedinteger nullable

Credits charged to this job per the ledger. 0 for failed/cancelled jobs (never charged) and zero-credit example jobs; null while the job is non-terminal (not counted yet) or for a succeeded job predating the ledger.

Changes

No recorded changes to this operation across all 1 revision of this API.