---
title: "List Thread Comments"
method: GET
path: "/v1/documents/{documentId}/threads/{threadId}/comments"
tags: ["Document Comments"]
---

# List Thread Comments

`GET /v1/documents/{documentId}/threads/{threadId}/comments`

Retrieves all comments within a specific thread of a document. Each comment includes the author, comment text, creation timestamp, and any assigned users.

## Valid Authentication Methods

**API Key Grants:**
- `DocumentReadonly`

**OAuth 2.0 User Token Scopes:**
- `lucidchart.document.content:readonly`
- `lucidscale.document.content:readonly`
- `lucidspark.document.content:readonly`
- `lucid.document.content:readonly`

## Path parameters

- `documentId` string, uuid, required
- `threadId` string, required

## Response `200`

OK with an array of Document Comment resources for the thread's comments.

- DocumentComment[]
  - `threadId` string, required — The ID of the thread this comment belongs to.
  - `userId` integer, required — The ID of the user who posted the comment.
  - `comment` string, required — The text content of the comment.
  - `created` string, date-time, required — The date and time when the comment was created.
  - `assignees` integer[], nullable — List of user IDs assigned to this comment, or null if no users are assigned.

## Other responses

- `400` — Bad Request if the document ID is malformed.
- `403` — Forbidden if the app making the request does not have permission to the document, or if the document does not exist.
- `404` — Not Found if the specified thread does not exist on the document.

---

[API](https://skmtc.net/lucid/apis/lucid-rest-api.md) · [All operations](https://skmtc.net/lucid/apis/lucid-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lucid/lucid-rest-api/revisions/6a32cb9e1aa7/schema)