---
title: "Retrieve all comments for a specific item."
method: GET
path: "/authoring/v1/comments/by-item/{classification}/{id}"
tags: ["Authoring comments"]
---

# Retrieve all comments for a specific item.

`GET /authoring/v1/comments/by-item/{classification}/{id}`

Use the /comments/by-item/{classification}/{id} endpoint to fetch all comments that are associated to a specific item. Use the query parameter 'since' to fetch comments since a specific date. Conditional requests are supported.<br />User roles: admin, manager, editor, viewer

## Path parameters

- `classification` string, string, required
- `id` string, string, required

## Query parameters

- `since` string, date-time
- `offset` integer
- `limit` integer
- `order` 'descending' | 'ascending'
- `fields` string[]

## Response `200`

Successfully lists a paged result view of all comments for the given item, optionally filtered by date.

- object
  - `limit` integer, required — The page size.
  - `offset` integer, required — The number of items to skip from the beginning of the list.
  - `href` string, required — A link to the current page.
  - `next` string — A link to the next page. Only shown if a next page exists.
  - `previous` string — A link to the previous page. Only shown if a previous page exists.
  - `items` object[], required
    - `creatorId` string, required — The ID of the user that created the commment.
    - `id` string, required — The id of the comment.
    - `rev` string, required — The revision of the comment.
    - `message` string, required — The actual comment message.
    - `created` string, date-time, required — ISO-8601 formatted date.
    - `target` object, required
      - `id` string, required — The id of the item that the comment is associated with.
      - `classification` 'asset' | 'content', required — The classification of the item that the comment is associated with.
    - `threadId` string, required — The id string of the thread that this comment belongs to.
    - `classification` string, required — The comment's classification.
    - `kind` string[], required — The "kind" of comment that this is. By default, all comments created by users are "user" comments.
    - `creator` string, required — Display name of the user who created this comment.
    - `lastModifier` string, required — The display name of the user who last edited the comment.
    - `lastModifierId` string, required — The ID of the user who last edited the comment.
    - `lastModified` string, required — The ISO-8601 timestamp that the comment was last modified.
    - `resolved` boolean, required — Used for resolving comments during a review. This property is false by default and changes to true when the comment is resolved.

## Other responses

- `304` — The Etag value that is provided in the If-None-Match header corresponds to the recent version.
- `429` — Too Many Requests, the server has reached a limit, the request must be sent again at a later time.
- `503` — Unable to list the comments in the database as the service is unavailable. Try again later.
- `default` — Unexpected error.

---

[API](https://skmtc.net/goacoustic/apis/acoustic-content-api.md) · [All operations](https://skmtc.net/goacoustic/apis/acoustic-content-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/goacoustic/acoustic-content-api/versions/677305266d89/schema)