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

# List comments

> List the comments on a Page post, replies included.

Lists every comment on a post. With `filter=stream`, replies are included and a reply carries `parent.id`.

## Authentication

Use the `hmat_` channel token from `GET /meta/channels/{id}/token` or `hookmyapp channels token <channel>`. Do not use an `hmok_` API key for this call.

```bash theme={null}
Authorization: Bearer hmat_...
```

## Path parameters

<ParamField path="postId" type="string" required>
  The post id, `{pageId}_{postId}`.
</ParamField>

## Query parameters

<ParamField query="fields" type="string">
  Use `id,from,message,created_time,is_hidden,parent`.
</ParamField>

<ParamField query="filter" type="string">
  `stream` for every comment oldest first, replies included. Omit for top-level comments only.
</ParamField>

<ParamField query="limit" type="integer">
  Page size, up to 100.
</ParamField>

<ParamField query="after" type="string">
  Cursor from a previous response's `paging.cursors.after`.
</ParamField>

## Example

```bash theme={null}
curl "https://gateway.hookmyapp.com/meta/v25.0/{POST_ID}/comments?fields=id,from,message,created_time,is_hidden,parent&filter=stream" \
  -H "Authorization: Bearer hmat_..."
```

## Successful response

```json theme={null}
{
  "data": [
    {
      "id": "500000000000001_500000000000002",
      "from": { "id": "200000000000001", "name": "Test User" },
      "message": "hello",
      "created_time": "2026-09-15T09:18:41+0000",
      "is_hidden": false
    }
  ],
  "paging": { "cursors": { "before": "...", "after": "..." } }
}
```