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

# List comments

> Get all comments for a site or page.

Returns comments for a site, optionally filtered by page URL, status, priority, or assignee.

<Note>
  Requires authentication via `X-API-Key: sf_your_api_key_here`.
</Note>

## Query parameters

<ParamField query="site_id" type="string" required>
  UUID of the site to fetch comments for.
</ParamField>

<ParamField query="route" type="string" required>
  URL path or route of the page, for example `/` or `/about`.
</ParamField>

<ParamField query="device_type" type="string" required>
  Device type: `DESKTOP`, `MOBILE`, or `TABLET`.
</ParamField>

<ParamField query="page_url" type="string">
  Filter comments by a specific page URL.
</ParamField>

<ParamField query="status" type="string">
  Filter by status: `OPEN`, `RESOLVED`, `IN_PROGRESS`, or `CLOSED`.
</ParamField>

<ParamField query="priority" type="string">
  Filter by priority: `LOW`, `MEDIUM`, `HIGH`, or `URGENT`.
</ParamField>

<ParamField query="assigned_to" type="string">
  UUID of the user the comments are assigned to.
</ParamField>

<ParamField query="per_page" type="integer">
  Results per page. Default: `25`. Max: `100`.
</ParamField>

<ParamField query="page" type="integer">
  Page number. Default: `1`.
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "data": {
      "data": [
        {
          "id": "990e8400-e29b-41d4-a716-446655440004",
          "content": "The header looks misaligned on mobile.",
          "status": "OPEN",
          "priority": "HIGH",
          "page_url": "https://example.com/home",
          "created_by": { "id": "...", "name": "Jane Smith" },
          "assigned_to": null,
          "created_at": "2026-03-01T10:00:00Z"
        }
      ],
      "current_page": 1,
      "total": 42
    }
  }
  ```
</ResponseExample>