---
title: "Get bulk download status"
method: GET
path: "/renders/bulk-download/{jobId}"
tags: ["Renders"]
---

# Get bulk download status

`GET /renders/bulk-download/{jobId}`

## Request

- Base URL: `https://api.cut.pro/api/v1`
- URL: `https://api.cut.pro/api/v1/renders/bulk-download/{jobId}`
- Auth: API key in header `X-Api-Key`

Returns the current state of a bulk download job. Poll every 5–10 seconds until `status` is `completed`. Once complete, `download_url` is a signed URL valid for one hour; the underlying file is purged once `expires_at` passes.

## Path parameters

- `jobId` string, required

## Response `200`

Response for status 200

- object
  - `id` string, required
  - `status` 'queued' | 'active' | 'completed' | 'failed', required
  - `progress` number, required: 0 to 100
  - `render_count` number, required
  - `file_size` number, nullable, required: Final zip size in bytes; `null` until completed
  - `error_code` string, nullable, required
  - `created_at` string, required
  - `completed_at` string, nullable, required
  - `expires_at` string, required
  - `download_url` string, nullable, required: Signed URL valid for 1h. Only populated when `status` is `completed`.
  - `filename` string, nullable, required

## Other responses

- `404`: Response for status 404
- `410`: Response for status 410

---

[API](https://skmtc.dev/cut/apis/cutpro-api.md) · [All operations](https://skmtc.dev/cut/apis/cutpro-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cut/apis/cutpro-api/revisions/89d0bafe529c?raw)