Check job status

Poll this endpoint until status is complete or failed. Recommended poll interval: 1–2 seconds.

Endpoint

GET /v1/generate/jobs/:jobId

Path parameters

Parameter	Type	Description
`jobId`	string	Job ID returned from `POST /v1/generate`

Status values

Status	Meaning
`queued`	Waiting to be picked up by a worker
`processing`	Rendering in progress
`complete`	PDF is ready to download
`failed`	Generation failed — see `errorMessage`

Avoid tight polling loops. Start at 1 second, then increase to 2–3 seconds if jobs routinely take longer. Or skip polling entirely with webhooks.

curl https://api.pdfox.com/v1/generate/jobs/job_7c9d2e3f \
  -H "Authorization: Bearer pdfs_live_xxxx"

{
  "jobId":       "job_7c9d2e3f",
  "status":      "complete",
  "templateId":  "tpl_8f3e2a1b",
  "createdAt":   "2026-05-17T10:00:00Z",
  "completedAt": "2026-05-17T10:00:03Z"
}