API reference

Jobs

List, inspect, retry, and read the result of conversion jobs.

List & get

GEThttps://api.markitdown.ai/jobsList conversion jobs (paginated)

GEThttps://api.markitdown.ai/jobs/{id}Get a single job and its status

GET /jobs accepts an optional cursor query for pagination. A job reports its status (queued, running, completed, failed).

GEThttps://api.markitdown.ai/jobs/{id}/resultThe converted Markdown

GEThttps://api.markitdown.ai/jobs/{id}/sourceA link to the original uploaded file

result is available once the job status is completed; before that it returns 404.

GEThttps://api.markitdown.ai/jobs/{id}/eventsServer-Sent Events stream of job progress

Subscribe to a job's progress as Server-Sent Events instead of polling — useful for interactive UIs.

POSThttps://api.markitdown.ai/jobs/{id}/retryRe-run a failed job

DELETEhttps://api.markitdown.ai/jobs/{id}Delete a job and its output