📊

Conversion Job Status

Poll an asynchronous conversion job for status and results.

GET 1 credit /v1/convert/jobs/{job_id}

curl "https://convert.toolkitapi.io/v1/convert/jobs/01HG0PVXYZ" \
  -H "Authorization: Bearer YOUR_API_KEY"

import httpx

resp = httpx.get(
    "https://convert.toolkitapi.io/v1/convert/jobs/01HG0PVXYZ",
)
print(resp.json())

const resp = await fetch("https://convert.toolkitapi.io/v1/convert/jobs/01HG0PVXYZ", {
});
const data = await resp.json();
console.log(data);

# See curl example

Response 200 OK

{
  "job_id": "01HG0PVXYZ",
  "status": "completed",
  "conversion": {
    "source_format": "docx",
    "target_format": "pdf",
    "source_size_bytes": 524288,
    "original_filename": "report.docx"
  },
  "file_name": "report.pdf",
  "file_type": "application/pdf",
  "file_size_bytes": 612345,
  "created_at": "2026-04-16T15:00:00Z",
  "updated_at": "2026-04-16T15:00:12Z"
}

Try It Live

Description

Poll an asynchronous conversion job for status and results.

How to Use

1

1. Submit a conversion job via the async endpoint. The response returns a `job_id` and `poll_url`.

2

2. GET this endpoint (`/v1/convert/jobs/{job_id}`) periodically — a few seconds between polls is appropriate.

3

3. When `status` is `completed`, download the output from `file_url`.

About This Tool

Poll an async conversion job by its `job_id`. Long-running conversions (large videos, multi-hundred-page PDFs) are accepted as background jobs that return an accepted response with a `poll_url`; use this endpoint to check progress and retrieve the result.

`status` progresses through `queued` → `running` → `completed` (or `failed`). On completion, the response includes `file_url` (presigned) and output metadata.

Why Use This Tool

Large file conversions — Handle videos or long PDFs that exceed synchronous timeouts
Batch pipelines — Fire-and-forget conversions with later retrieval
Webhook-free integrations — Poll for status without needing to expose a callback endpoint
Retry logic — Inspect `status: failed` and retry with adjusted parameters

Frequently Asked Questions

How often should I poll?

Every 2–5 seconds for most jobs; longer for very large conversions. Avoid tight polling loops.

How long are completed files retained?

Output files are retained for a short period (typically 24 hours). Download them promptly.

What happens on failure?

`status` becomes `failed` and the response includes an `error` message describing the cause.

Start using Conversion Job Status now

Get your free API key and make your first request in under a minute.

Get Free API Key View Docs