---
title: "Download frame-accurate scene media for this document."
method: GET
path: "/v1/collections/{collection_identifier}/documents/{document_id}/download"
tags: ["Collection Documents"]
---

# Download frame-accurate scene media for this document.

`GET /v1/collections/{collection_identifier}/documents/{document_id}/download`

## Request

- Base URL: `https://api.mixpeek.com`
- URL: `https://api.mixpeek.com/v1/collections/{collection_identifier}/documents/{document_id}/download`
- Auth: HTTP bearer and API key in header `X-Namespace`

Export this scene's media cut frame-accurately to its time range.

The document's ``video_segment_url`` serves the extraction-time clip,
which is stream-copied and therefore keyframe-bounded — it can overshoot
``[start_time, end_time]`` by up to a GOP (~1s). This endpoint re-cuts
from the ORIGINAL source with re-encode so the exported media matches the
declared range within one source frame, caches the
result beside the extraction clip, and returns a presigned download URL.
The first call for a given range pays the re-encode (seconds, bounded);
repeat calls serve the cache.

## Path parameters

- `collection_identifier` string, required: The ID or name of the collection.
- `document_id` string, required: The ID of the scene document.

## Response `200`

Successful Response

- SceneDownloadResponse
  - `download_url` string, required: Presigned URL for the frame-accurate media cut.
  - `cached` boolean, required: Whether the cut was served from cache.
  - `start_time` number, required: Scene start time in seconds.
  - `end_time` number, required: Scene end time in seconds.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `422`: Unprocessable Entity
- `429`: Too Many Requests
- `500`: Internal Server Error
- `503`: Service Unavailable

## Changes

- **2026-10-09** `61a175e8eb9a`: 1 warning, 5 info
  - removed the optional property `detail` from the response with the `422` status
  - added the non-success response with the status `429`
  - added the non-success response with the status `503`
  - added the optional property `success` to the response with the `422` status
  - …2 more
- **2026-08-23** `27f74c951c4d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/mixpeek/apis/mixpeek-api/changes/v1/collections/:collection_identifier/documents/:document_id/download/get.md)

---

[API](https://skmtc.dev/mixpeek/apis/mixpeek-api.md) - [All operations](https://skmtc.dev/mixpeek/apis/mixpeek-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mixpeek/apis/mixpeek-api/revisions/790bc16455f6?raw)