---
title: "A link to a finished export or one of its sidecars"
method: GET
path: "/marketing/exports/{id}/download"
tags: ["marketing"]
---

# A link to a finished export or one of its sidecars

`GET /marketing/exports/{id}/download`

## Request

- Base URL: `https://api.gogoscreen.com/api/v1`
- URL: `https://api.gogoscreen.com/api/v1/marketing/exports/{id}/download`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

A short-lived signed URL for the export's MP4 (`asset=video`, the default) or one of its sidecars: the cover JPEG, the SRT captions, or the approved transcript. 409 while the export is not finished; 410 once the file was deleted at the end of the retention period; 404 when the export never produced that sidecar.

## Path parameters

- `id` string, uuid, required

## Query parameters

- `asset` 'video' | 'cover' | 'captions' | 'transcript'
- `attachment` boolean

## Response `200`

A link to a finished export or one of its sidecars

- object
  - `expiresAt` string, date-time, required: When the URL stops working.
  - `url` string, required: A signed URL. Short-lived, single-purpose, and not shareable.

## Other responses

- `400`: `validation_failed` — That request is not valid.
- `401`: `unauthorized` — Authentication is required.
- `403`: `forbidden_scope` — This credential does not carry the scope this operation needs.
- `404`: `not_found` — No such resource.
- `409`: `not_finished` — That export is not finished yet.
- `410`: `expired` — That file is past its retention window and has been deleted.
- `429`: `rate_limited` — Too many requests. Try again shortly.
- `500`: `internal_error` — Something went wrong. Try again.
- `503`: `storage_unavailable` — File storage is temporarily unavailable.

---

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