---
title: "List PDF jobs"
method: GET
path: "/v1/pdf/jobs"
tags: ["PDF Async"]
---

# List PDF jobs

`GET /v1/pdf/jobs`

List async PDF generation jobs for your team.

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

Supports pagination and filtering by status.

## Query parameters

- `limit` integer — Maximum number of results to return
- `offset` integer — Number of results to skip (for pagination)
- `status` 'pending' | 'processing' | 'completed' | 'failed' — PDF job status values

## Response `200`

Jobs list retrieved

- JobListResponse — Response for job list query
  - `jobs` JobStatusResponse[], required — List of jobs
    - `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
  - `total` integer, required — Total number of jobs matching filter
  - `limit` integer, required — Page size
  - `offset` integer, required — Page offset

## Other responses

- `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)