---
title: "List comments"
method: GET
path: "/v1/data/{artifactId}/comments"
tags: ["Data"]
---

# List comments

`GET /v1/data/{artifactId}/comments`

## Request

- Base URL: `https://shareout.site`
- URL: `https://shareout.site/v1/data/{artifactId}/comments`
- Auth: HTTP bearer

Comments on the artifact, newest first. Session cookie or Bearer token; the artifact's comment identity mode decides who may read. `403 COMMENTS_DISABLED` when comments are off for the artifact.

## Query parameters

- `contextId` string
- `parentId` string
- `resolved` 'true' | 'false'
- `assignee` string
- `limit` integer
- `skip` integer

## Response `200`

Comments

- object
  - `success` boolean
  - `data` object
    - `comments` Comment[]
      - `id` string: `cmt_` + 24 hex characters.
      - `contextId` string, nullable
      - `parentId` string, nullable
      - `authorId` string, nullable
      - `authorName` string
      - `content` string
      - `createdAt` string, date-time
      - `updatedAt` string, date-time
      - `resolved` boolean
      - `resolvedBy` string, nullable
      - `resolvedAt` string, date-time, nullable
      - `position` unknown
      - `mentions` string[]
      - `authorType` 'human' | 'agent' | 'guest': `guest` = a verified guest with no account (their email is never returned).
      - `assigneeUserId` string, nullable
      - `assigneeEmail` string, nullable
      - `dueAt` string, date-time, nullable
      - `versionId` string, nullable: Id of the version that was live when the comment was written; null on older comments.
      - `reactions` object
    - `count` integer

## Other responses

- `403`: Access denied

## Changes

- **2026-10-16** `8c602e339d5d`: 1 warning
  - added the new `guest` enum value to the `data/comments/items/authorType` response property for the response status `200`
- **2026-10-16** `924c2aeaed12`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/shareout/apis/shareout-rest-api/changes/v1/data/:artifactId/comments/get.md)

---

[API](https://skmtc.dev/shareout/apis/shareout-rest-api.md) - [All operations](https://skmtc.dev/shareout/apis/shareout-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/shareout/apis/shareout-rest-api/revisions/1e3f7fd34f6d?raw)