---
title: "Obtain a highlight reel download link"
method: GET
path: "/api/v2/testResults/{testId}/highlightreels/{reelId}"
tags: ["Video Data"]
---

# Obtain a highlight reel download link

`GET /api/v2/testResults/{testId}/highlightreels/{reelId}`

Returns the details of a highlight reel and a link to download it.

If the highlight reel is still being prepared, the response returns a status of `GENERATING` and no link. Call this endpoint again every few seconds until the status becomes `GENERATED`, then use the `reelUrl` to download the highlight reel. The link is valid for 15 minutes; after it expires, call the endpoint again to get a new one.

  _Compatibility:_
  - Tests must be of the "STUDYV2" type and belong to one of the following product types:
    - "LIVE_CONVERSATION" (non-classic live conversation)
    - "NON_THINK_OUT_LOUD" (interaction test)
    - "THINK_OUT_LOUD" (think-out-loud test).
  - Go to [How to Obtain a Test ID (UUID)](https://developer.usertesting.com/docs/how-to-obtain-a-testid-uuid) for details.

## Path parameters

- `testId` string, uuid, required
- `reelId` string, uuid, required

## Response `200`

Highlight reel details successfully returned.

- ReelDetailsResponseDto
  - `reelId` string, uuid, required — ID of the highlight reel.
  - `status` 'GENERATING' | 'GENERATED' | 'ERROR', required — Current state of the highlight reel. - `GENERATING`: the highlight reel is being prepared. Try again in a few seconds. - `GENERATED`: the highlight reel is ready and `reelUrl` contains the download link. - `ERROR`: something went wrong while preparing the highlight reel. Try the request again to start a new attempt.
  - `reelUrl` string, url, nullable — Link to download the highlight reel file. Valid for 15 minutes. Returned only when the status is `GENERATED`; call this endpoint again to get a new link after it expires.

## Other responses

- `401` — Missing or invalid access token.
- `404` — Highlight reel not found.
- `429` — Too many requests. Maximum of 10 requests per minute.

---

[API](https://skmtc.net/usertesting/apis/results-api.md) · [All operations](https://skmtc.net/usertesting/apis/results-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/usertesting/results-api/versions/8124f6985018/schema)