---
title: "Obtain a clip download link"
method: GET
path: "/api/v2/sessionResults/{sessionId}/clips/{clipUuid}"
tags: ["Video Data"]
---

# Obtain a clip download link

`GET /api/v2/sessionResults/{sessionId}/clips/{clipUuid}`

Returns the details of a clip and a link to download it.

If the clip 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 `clipUrl` to download the clip. The link is valid for 15 minutes; after it expires, call the endpoint again to get a new one.

  _Compatibility:_
  - Sessions must be found within tests with the "STUDYV2" type and belong to one of the following product types that support session video clips:
    - "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

- `sessionId` string, uuid, required
- `clipUuid` string, uuid, required

## Response `200`

Clip details successfully returned.

- ClipDetailsResponseDto
  - `clipUuid` string, uuid, required — ID of the clip.
  - `status` 'GENERATING' | 'GENERATED' | 'ERROR', required — Current state of the clip. - `GENERATING`: the clip is being prepared. Try again in a few seconds. - `GENERATED`: the clip is ready and `clipUrl` contains the download link. - `ERROR`: something went wrong while preparing the clip. Try the request again to start a new attempt.
  - `clipUrl` string, url, nullable — Link to download the clip 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` — Clip 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)