> ## 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 top-level comments on a post.

Returns top-level comments, 50 per page, with cursor paging.<br />
Always request `fields` explicitly — Meta's default response omits `from` and `text`.

## Authentication

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

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

## Path parameters

<ParamField path="mediaId" type="string" required>
  The media ID to list comments for.
</ParamField>

## Query parameters

<ParamField query="fields" type="string" required>
  Comma-separated fields: `id`, `from`, `text`, `timestamp`, `like_count`, `hidden`, `parent_id`, `replies`.
</ParamField>

For nested replies, add `replies` to `fields` or call `GET /{commentId}/replies` directly.

## Example

```bash theme={null}
curl "https://gateway.hookmyapp.com/meta/v25.0/{MEDIA_ID}/comments?fields=id,from,text,timestamp,like_count,hidden" \
  -H "Authorization: Bearer hmat_..."
```

## Successful response

```json theme={null}
{
  "data": [
    {
      "id": "17900000000000000",
      "from": { "id": "17841400000000001", "username": "commenter" },
      "text": "Nice post!",
      "timestamp": "2026-07-23T10:00:00+0000",
      "like_count": 2,
      "hidden": false
    }
  ],
  "paging": { "cursors": { "before": "...", "after": "..." } }
}
```