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

# List Document Threads

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

Retrieves all comment threads for the specified document. Each thread includes its ID, creation timestamp, and status (open or closed).

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

## Response `200`

OK with an array of Document Thread resources for the document's comment threads.

- DocumentThread[]
  - `threadId` string, required — The unique ID of the comment thread.
  - `created` string, date-time, required — The date and time when the thread was created.
  - `status` 'OPEN' | 'CLOSED', required — The status of a comment thread. OPEN indicates an unresolved thread, CLOSED indicates a resolved thread.

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

---

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