GET
Get Job Status
https://api.screenshotfreeapi.com/jobs/{jobId}/status
Poll the status of a screenshot job. Returns the current state, a 0—100 progress integer, and an error message if the job has failed.
Status lifecycle
| Status | Meaning |
|---|---|
| queued | Job is waiting in the BullMQ queue |
| processing | Playwright is navigating and capturing |
| completed | Screenshot is ready — call GET /jobs/:id/result |
| failed | Job failed after all retries — see error field |
Response examples
Status responses
1// Queued
2{ "jobId": "job_web_7a91bcd3", "status": "queued", "progress": 0 }
3
4// Processing
5{ "jobId": "job_web_7a91bcd3", "status": "processing", "progress": 45 }
6
7// Completed
8{ "jobId": "job_web_7a91bcd3", "status": "completed", "progress": 100 }
9
10// Failed
11{
12 "jobId": "job_web_7a91bcd3",
13 "status": "failed",
14 "progress": 0,
15 "error": "Navigation timeout after 60000ms"
16}Recommended polling strategy
Poll every 2 seconds for the first 20 seconds, then every 5 seconds until completion or a 60-second timeout. For production workloads, use webhooks instead of polling to avoid burning rate-limit quota.