---
title: "Get PDF job status"
method: GET
path: "/v1/pdf/jobs/{job_id}"
tags: ["PDF Async"]
---

# Get PDF job status

`GET /v1/pdf/jobs/{job_id}`

Get the current status of an async PDF generation job.

**Authentication:** API Key required (`x-api-key` header)

## Status Values

| Status | Description |
|--------|-------------|
| `pending` | Job is queued, waiting to be processed |
| `processing` | Job is being processed |
| `completed` | PDF generated successfully |
| `failed` | Job failed (check error_message) |

## Polling Recommendations

- Poll every 1-2 seconds for small documents
- Poll every 5-10 seconds for large documents
- Consider using webhooks instead of polling

## Path parameters

- `job_id` string, required — Async job ID (UUID returned by the create-async endpoint)

## Response `200`

Job status retrieved

- JobStatusResponse — Response for job status query
  - `id` string, required — Job ID
  - `status` 'pending' | 'processing' | 'completed' | 'failed', required — PDF job status values
  - `template_id` string, required — Template used for generation
  - `export_type` string, required — Export type (url)
  - `filename` string, nullable — Custom filename if provided
  - `store_s3` boolean, required — Whether S3 storage was requested
  - `created_at` string, required — Job creation timestamp (ISO 8601)
  - `updated_at` string, required — Last update timestamp (ISO 8601)
  - `completed_at` string, nullable — Completion timestamp (ISO 8601)
  - `result_url` string, nullable — Signed URL to download PDF
  - `result_filename` string, nullable — Final filename
  - `result_expires_at` string, nullable — URL expiration (ISO 8601)
  - `result_s3_bucket` string, nullable — S3 bucket (if store_s3)
  - `result_s3_key` string, nullable — S3 object key (if store_s3)
  - `error_message` string, nullable — Error description if failed
  - `error_code` string, nullable — Error code if failed

## Other responses

- `404` — Job not found
- `422` — Validation Error

---

[API](https://skmtc.net/pdftemplateapi/apis/templatefox-api.md) · [All operations](https://skmtc.net/pdftemplateapi/apis/templatefox-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pdftemplateapi/templatefox-api/revisions/5673fc0d5fad/schema)