---
title: "List comments and replies for a recording"
method: GET
path: "/recordings/{public_id}/comments"
tags: ["REST API"]
---

# List comments and replies for a recording

`GET /recordings/{public_id}/comments`

## Request

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

Works with: Personal token Workspace token

Returns a flat oldest-first list of top-level comments and replies for the recording, with their emoji reactions. Replies reference their parent comment via \`parent\_public\_id\`. Mentions in \`content\` read \`@name\`, and \`mentions\` lists who was mentioned.

## Path parameters

- `public_id` string, required

## Response `200`

200

- object
  - `data` object, required
    - `public_id` string, required
    - `comments` object[], required
      - `public_id` string, required: This comment's public id, distinct from the list's recording `public_id`.
      - `parent_public_id` string, nullable, required: The parent comment's `public_id` for a reply, null for a top-level comment. The parent may be deleted and no longer listed.
      - `content` string, required: Comment text, with mentions as `@name`. `mentions` lists who was mentioned.
      - `mentions` object[], required: Each mentioned user once, in order of first appearance. Deleted users are left out.
        - `public_id` string, required: Public user id, the same for this person everywhere.
        - `name` string, required
        - `avatar_url` string, nullable, required
      - `timestamp_ms` number, required
      - `transcript_reference` string, nullable, required
      - `user` object, nullable, required: The author. Null for a deleted user.
        - `public_id` string, required: Public user id, the same for this person everywhere.
        - `name` string, required
        - `avatar_url` string, nullable, required
      - `reactions` object[], required
        - `emoji` string, required
        - `user` object, nullable, required: Null for a deleted user.
          - `public_id` string, required: Public user id, the same for this person everywhere.
          - `name` string, required
          - `avatar_url` string, nullable, required
        - `id` string, required: Deprecated: a comment reaction is identified by its comment, `user` and `emoji`.
        - `user_name` string, required: Deprecated: use `user.name`.
        - `user_avatar_url` string, nullable, required: Deprecated: use `user.avatar_url`.
      - `attachments` object[], required
        - `url` string, required
        - `thumbnail_url` string, required
        - `width` integer, required
        - `height` integer, required
        - `description` string, nullable, required
      - `id` string, required: Deprecated: use `public_id`.
      - `parent_id` string, nullable, required: Deprecated: use `parent_public_id`.
      - `user_name` string, required: Deprecated: use `user.name`.
      - `user_avatar_url` string, nullable, required: Deprecated: use `user.avatar_url`.

## 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)