---
title: "Find all highlight reels for a test"
method: GET
path: "/api/v2/testResults/{testId}/highlightreels"
tags: ["Video Data"]
---

# Find all highlight reels for a test

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

Returns all highlight reels for the test. Each highlight reel includes its ID, name, duration, last updated timestamp, clip count, and whether all test clips are included in the reel.

  _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.

  _Notes:_
  - Use the returned highlight reel ID to request highlight reel download link from the "GET /api/v2/testResults/{testId}/highlightreels/{reelId}" endpoint.

## Path parameters

- `testId` string, uuid, required

## Response `200`

Highlight reels successfully retrieved.

- HighlightReelsResponseDto
  - `reels` HighlightReelDto[], required — Highlight reels available for the study.
    - `uuid` string, uuid, required — ID of the highlight reel.
    - `name` string, required — Name of the highlight reel.
    - `durationMs` number, required — Highlight reel duration in milliseconds.
    - `lastUpdatedAtMs` number, required — Timestamp of the last highlight reel update in milliseconds.
    - `numClips` number, required — Number of clips in the highlight reel.
    - `areAllClipsInReel` boolean, required — Indicates whether all study clips are included in the reel.
  - `studyWithClips` boolean, required — Indicates whether the study has clips available.

## Other responses

- `401` — Missing or invalid access token.
- `404` — Test or highlight reels 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)