New sign-ups for the Free plan are temporarily paused. Paid plans remain available.
LDX hub API

ExtractDoc Jobs

Create and manage ExtractDoc text extraction jobs


List ExtractDoc job history

GET
https://gw.ldxhub.io
/extractdoc/jobs

Returns a list of jobs for the authenticated user, ordered by creation date descending. Use GET /extractdoc/jobs/{job_id} to retrieve full details for a specific job.

List ExtractDoc job history › Headers

Authorization
​string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

List ExtractDoc job history › Responses

A list of jobs


Create an ExtractDoc job

POST
https://gw.ldxhub.io
/extractdoc/jobs

Enqueues an asynchronous text extraction job. Upload your file via POST /files first, then submit the file_id here. Returns 202 Accepted immediately with a job_id. Poll GET /extractdoc/jobs/{job_id} to check completion. When completed, download the extracted output via GET /files/{output_file_id}/content.

Supported input formats: PDF, DOCX, XLSX, PPTX. The input format is automatically detected from the uploaded file.

Create an ExtractDoc job › Headers

Authorization
​string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Create an ExtractDoc job › Request Body

engine
​string · required

Engine ID obtained from GET /extractdoc/engines

file_id
​string · required

File ID of the input file to process, obtained from POST /files. Supported input formats: PDF, DOCX, XLSX, PPTX. The input format is automatically detected from the uploaded file.

output_format
​string · enum · required

Output format. Use 'text' for plain text, or 'jsonl' for a single-line JSON object compatible with StructFlow input.

Enum values:
text
jsonl

Create an ExtractDoc job › Responses

Job accepted

Full job details. Returned by GET /extractdoc/jobs/{job_id}.
job_id
​string
file_id
​string

Input file ID

engine
​string
status
​string · enum
Enum values:
queued
processing
completed
failed
progress
​number · float
output_file_id
​string

File ID of the extracted output. Present only when status is completed. Download via GET /files/{output_file_id}/content.

​JobError

Job-level error. Present only when job status is failed.

created_at
​string · date-time
updated_at
​string · date-time
completed_at
​string · date-time
expires_at
​string · date-time
​Usage

Get ExtractDoc job status and results

GET
https://gw.ldxhub.io
/extractdoc/jobs/{job_id}

Returns the current status of an ExtractDoc job. Poll this endpoint until status is completed or failed. Recommended polling interval: 1-5 seconds. When status is completed, use output_file_id to download the extracted output via GET /files/{output_file_id}/content. Results are retained for a limited period after completion (expires_at).

Get ExtractDoc job status and results › path Parameters

job_id
​string · required

The unique identifier of the job

Get ExtractDoc job status and results › Headers

Authorization
​string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Get ExtractDoc job status and results › Responses

Job details

Full job details. Returned by GET /extractdoc/jobs/{job_id}.
job_id
​string
file_id
​string

Input file ID

engine
​string
status
​string · enum
Enum values:
queued
processing
completed
failed
progress
​number · float
output_file_id
​string

File ID of the extracted output. Present only when status is completed. Download via GET /files/{output_file_id}/content.

​JobError

Job-level error. Present only when job status is failed.

created_at
​string · date-time
updated_at
​string · date-time
completed_at
​string · date-time
expires_at
​string · date-time
​Usage