> ## Documentation Index
> Fetch the complete documentation index at: https://developers.myhero.so/llms.txt
> Use this file to discover all available pages before exploring further.

# List comments

> Read a document's comments as the editor's comment panel shows them: for each thread, the passage it is on (on, in block blockId) and its comments by…

`list_comments`

Read a document's comments as the editor's comment panel shows them: for each thread, the passage it is on (`on`, in block `blockId`) and its comments by date, with author, text and reactions; a deleted comment keeps its place as `deleted`, without its text, as the panel shows it. `you` marks comments posted as the user, yours included. A `detached` thread has lost its passage and is hidden in the editor. Resolved threads are left out unless includeResolved. For a Word file use docx\_comment.

## Parameters

**documentId** `string` *required*

The HERO document.

**includeResolved** `boolean`

Also list resolved threads.

**offset** `integer`

Where to start. Pass the previous result's page.nextOffset. Minimum: 0.

**limit** `integer`

How many to return at most; the result may hold fewer to fit. Minimum: 1.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.