---
title: "A link to the finished video"
method: GET
path: "/renders/{id}/download"
tags: ["renders"]
---

# A link to the finished video

`GET /renders/{id}/download`

## Request

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

A short-lived signed URL for a finished render's MP4, and when it stops working. The bytes are never proxied through this API: fetch the URL directly. Requires a verified email address — an anonymous render is free to make and costs an email to keep.

## Path parameters

- `id` string, uuid, required

## Response `200`

A link to the finished video

- 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_ready` — That video is not finished yet.
- `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)