---
title: "Get batch job status"
method: GET
path: "/v1/screenshot/batch/{jobId}"
---

# Get batch job status

`GET /v1/screenshot/batch/{jobId}`

## Request

- Base URL: `https://app.snap-render.com`
- URL: `https://app.snap-render.com/v1/screenshot/batch/{jobId}`
- Auth: API key in header `X-API-Key`

Poll the status of a batch screenshot job. Returns current progress and download URLs for completed items. Download URLs are presigned and valid for 24 hours.

## Path parameters

- `jobId` string, uuid, required

## Response `200`

Batch job status

- BatchJobResponse
  - `jobId` string, uuid: Unique batch job identifier
  - `status` 'pending' | 'processing' | 'completed' | 'failed': Overall job status
  - `statusUrl` string: URL to poll for status updates
  - `total` integer: Total number of URLs in the batch
  - `completed` integer: Number of successfully completed screenshots
  - `failed` integer: Number of failed screenshots
  - `items` object[]
    - `url` string: The URL that was captured
    - `status` 'pending' | 'completed' | 'failed'
    - `downloadUrl` string: Presigned download URL (24h validity, present when completed)
    - `error` string: Error message (present when failed)
  - `createdAt` string, date-time
  - `completedAt` string, date-time: Present when job is completed or failed

## Other responses

- `401`: Unauthorized
- `404`: Job not found or expired

---

[API](https://skmtc.dev/snap-render/apis/snaprender-screenshot-api.md) · [All operations](https://skmtc.dev/snap-render/apis/snaprender-screenshot-api/llms.txt) · [OpenAPI document](https://skmtc.dev/snap-render/apis/snaprender-screenshot-api/revisions/420ff88deeb2?raw)