---
title: "Get a download URL for a clip batch ZIP"
method: GET
path: "/clip-batches/{batch_id}/archive"
tags: ["Clip Creation"]
---

# Get a download URL for a clip batch ZIP

`GET /clip-batches/{batch_id}/archive`

## Request

- Base URL: `https://blitzreels.com/api/v1`
- URL: `https://blitzreels.com/api/v1/clip-batches/{batch_id}/archive`
- Auth: API key in header `Authorization`

Returns a signed ZIP URL when the archive of accepted clips is stored. Otherwise queues the archive and returns preparing with retry_after_seconds, or unavailable when the batch has no downloadable clips.

## Path parameters

- `batch_id` string, uuid, required

## Response `200`

Successful response

- union
  - object
    - `status` 'ready', required
    - `batch_id` string, required
    - `download_url` string, uri, required
    - `file_name` string, required
    - `expires_at` string, date-time, required
  - object
    - `status` 'preparing', required
    - `batch_id` string, required
    - `reason` 'archive_building' | 'exports_pending', required
    - `retry_after_seconds` integer, required
  - object
    - `status` 'unavailable', required
    - `batch_id` string, required
    - `reason` 'no_completed_clips' | 'invalid_completed_exports', required

## Other responses

- `400`: Invalid input data
- `401`: Authorization not provided
- `403`: Insufficient access
- `404`: Not found
- `500`: Internal server error

---

[API](https://skmtc.dev/blitzreels/apis/blitzreels-api.md) · [All operations](https://skmtc.dev/blitzreels/apis/blitzreels-api/llms.txt) · [OpenAPI document](https://skmtc.dev/blitzreels/apis/blitzreels-api/revisions/35608b12471d?raw)