AnalyzeDoc Jobs
Create and manage AnalyzeDoc document analysis jobs
List AnalyzeDoc job history
Returns a list of jobs for the authenticated user, ordered by creation date descending.
Use GET /analyzedoc/jobs/{job_id} to retrieve full details for a specific job.
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
List AnalyzeDoc job history › Responses
A list of jobs
Create an AnalyzeDoc job
Enqueues an asynchronous document analysis job.
Upload your PDF or image file via POST /files first, then submit the file_id here.
The vision AI model reads the document and returns structured JSON following your example_output.
Returns 202 Accepted immediately with a job_id.
Poll GET /analyzedoc/jobs/{job_id} to check completion.
When completed, download the extracted JSON via GET /files/{output_file_id}/content.
Supported input formats: PDF, JPEG, PNG.
The input format is automatically detected from the uploaded file.
Format support varies by model — the request is rejected with 400 if the selected model does not support the detected input format.
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
Create an AnalyzeDoc job › Request Body
modelModel ID obtained from GET /analyzedoc/models, including the resolution variant suffix (e.g. '@high').
system_promptInstruction describing what structured data to extract from the document and how
example_outputA JSON object showing the desired output structure with example values. Key order matters: it guides the order in which fields are generated (a hint, not a guarantee), so place discriminator fields such as 'type' first. Keys set to null in the example become optional in the output.
file_idFile ID of the input document to analyze, obtained from POST /files. Supported input formats: PDF, JPEG, PNG. The input format is automatically detected from the uploaded file. Format support varies by model — check 'supported_conversions' in GET /analyzedoc/models.
output_formatOutput format
Create an AnalyzeDoc job › Responses
Job accepted
job_idUnique job identifier. Use this to poll for results.
modelstatusprogresscreated_atupdated_atexpires_atGet AnalyzeDoc job status and results
Returns the current status of an AnalyzeDoc 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 JSON
via GET /files/{output_file_id}/content.
Results are retained for a limited period after completion (expires_at).
path Parameters
job_idThe unique identifier of the job
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
Get AnalyzeDoc job status and results › Responses
Job details
job_idfile_idInput file ID
modelstatusprogressoutput_file_idFile ID of the extracted JSON output. Present only when status is completed. Download via GET /files/{output_file_id}/content.
Job-level error. Present only when job status is failed.
created_atupdated_atcompleted_atexpires_at
