---
title: "Find all clips for a session video"
method: GET
path: "/api/v2/sessionResults/{sessionId}/clips"
tags: ["Video Data"]
---

# Find all clips for a session video

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

Returns the clips created from a session video, including clip timing, media flags, layout, and video region metadata.

  _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

## Response `200`

Clips successfully retrieved.

- ClipsResponseDto
  - `studyUuid` string, uuid, required — ID of the test associated with the clip list.
  - `clips` ClipDto[], required — Clips available for the session video.
    - `uuid` string, uuid, required — ID of the clip.
    - `name` string, required — Name of the clip.
    - `description` string — Description of the clip.
    - `timeStartMs` number, required — Clip start time in milliseconds from the session start.
    - `timeEndMs` number, required — Clip end time in milliseconds from the session start.
    - `videoUuid` string, uuid, required — ID of the video session that contains the clip.
    - `hasAudio` boolean, required — Indicates whether the clip has audio.
    - `hasCamera` boolean, required — Indicates whether the clip has camera video.
    - `layout` ClipLayoutDto
      - `mainStream` 'SCREEN' | 'CAMERA', required — Primary stream shown for the clip.
      - `pipPosition` 'TOP_LEFT' | 'TOP_RIGHT' | 'BOTTOM_LEFT' | 'BOTTOM_RIGHT', required — Picture-in-picture position.
      - `pipState` 'OPENED' | 'CLOSED', required — Picture-in-picture state.
  - `videoRegions` ClipVideoRegionsDto
    - `screen` ClipVideoRegionDto
      - `topLeftPoint` ClipPointDto
        - `x` number, required — Horizontal coordinate in pixels.
        - `y` number, required — Vertical coordinate in pixels.
      - `widthPx` number, required — Video region width in pixels.
      - `heightPx` number, required — Video region height in pixels.
    - `camera` ClipVideoRegionDto
      - `topLeftPoint` ClipPointDto
        - `x` number, required — Horizontal coordinate in pixels.
        - `y` number, required — Vertical coordinate in pixels.
      - `widthPx` number, required — Video region width in pixels.
      - `heightPx` number, required — Video region height in pixels.

## Other responses

- `401` — Missing or invalid access token.
- `404` — Session video or clips 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)