Get the status and result of an async parse job
Get the status and result of an async parse job
Poll for the status and result of an async parse job submitted via POST /api/v1/parse with options.async=true. Returns the same envelope shape as the synchronous parse endpoint once status is completed.
curl https://api.context212.com/api/v1/parse/parse_Kg \ -H 'Authorization: Bearer $TOKEN'Recommended polling cadence: 1s for the first 10s, then 5s, capped at 30s. Stop polling once status is in {completed, failed}.
Authorization
bearerAuth Console session token (Authorization: Bearer <session>) or product API key (Authorization: Bearer <api-key> or x-api-key). Session tokens are validated via Better Auth get-session; API keys against the shared database.
In: header
Path Parameters
Public parse job id (e.g. parse_Kg) returned by POST /api/v1/parse with options.async=true. Malformed or unknown tokens return 404.
Header Parameters
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/api/v1/parse/0"{ "id": "string", "status": "string", "created_at": "2019-08-24T14:15:22Z", "completed_at": "2019-08-24T14:15:22Z", "processing_time_ms": 0, "document": { "filename": "string", "page_count": 0, "file_size_bytes": 0, "mime_type": "string" }, "result": { "pages": [ { "index": 0, "markdown": "string" } ] }, "usage": { "pages_processed": 0 }, "progress": { "percentage": 0, "pages_processed": 0 }, "error": { "message": "string" }}Parse a document to Markdown POST
Parse a document to Markdown Convert a document into readable, structured Markdown content. Accepts either a **file upload** (multipart/form-data) or a **document URL** (JSON body). ### Sync mode (default) Blocks until parsing completes and returns **200** with the full markdown result. ```bash curl -X POST https://api.context212.com/api/v1/parse \ -H 'Authorization: Bearer $TOKEN' \ -F file=@invoice.pdf ``` ### Async mode (`options.async = true`) Not implemented yet — returns **501**. **Supported file types:** `.pdf`, `.png`, `.jpg`, `.jpeg`, `.pptx`, `.docx`, `.xlsx`, `.html`, `.xhtml` **Sync limits:** 20 MB file size, 15 pages.
Render a document as PDF POST
Render a document as PDF Convert a document into a PDF suitable for inline preview. Accepts a **file upload** (multipart/form-data), a **document URL**, or a **file_id** referencing a document already ingested in the platform (JSON body). The conversion is synchronous — the PDF bytes are returned directly. **Supported file types:** `.pdf`, `.png`, `.jpg`, `.jpeg`, `.pptx`, `.ppt`, `.odp`, `.docx`, `.odt`, `.doc`, `.html`, `.xhtml` **Size limit:** 20 MB.