---
title: "List recordings"
method: GET
path: "/recordings"
tags: ["REST API"]
---

# List recordings

`GET /recordings`

## Request

- Base URL: `https://api.supercut.ai/v1`
- URL: `https://api.supercut.ai/v1/recordings`
- Auth: HTTP bearer

Works with: Personal token

Paginated list of recordings visible in the workspace. Use \`list=owned|watched|shared\` to choose the list. \`search\` is supported only for \`list=owned\`. Owned items include all-time viewership counts (visits and plays, total and unique, aggregated across versions).

## Query parameters

- `list` 'owned' | 'watched' | 'shared'
- `search` string
- `cursor` string
- `limit` integer

## Response `200`

200

- object
  - `data` object, required
    - `items` object[], required
      - `public_id` string, required
      - `link` string, required: The recording's page: on the workspace's custom domain when it has one, else on the Supercut app that served the response.
      - `title` string, required
      - `created_at` string, required
      - `duration_ms` number, nullable, required
      - `workspace_safename` string, required
      - `last_watched_at` string
      - `analytics` object
        - `visits` object, required
          - `total` number, required
          - `unique` number, required
        - `plays` object, required
          - `total` number, required
          - `unique` number, required
    - `next_cursor` string, nullable, required

## Other responses

- `400`: 400
- `401`: 401
- `402`: 402
- `403`: 403
- `404`: 404
- `409`: 409
- `429`: 429
- `500`: 500

---

[API](https://skmtc.dev/supercut/apis/supercut-platform-api.md) · [All operations](https://skmtc.dev/supercut/apis/supercut-platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/supercut/apis/supercut-platform-api/revisions/66033895a858?raw)