Skip to main content
GET
/
comments
List comments
curl --request GET \
  --url https://api.surefeedback.com/api/v1/comments \
  --header 'X-API-Key: <api-key>'
{
  "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
  }
}

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.

Returns comments for a site, optionally filtered by page URL, status, priority, or assignee.
Requires authentication via X-API-Key: sf_your_api_key_here.

​
Query parameters

​
site_id
string
required
UUID of the site to fetch comments for.
​
route
string
required
URL path or route of the page, for example / or /about.
​
device_type
string
required
Device type: DESKTOP, MOBILE, or TABLET.
​
page_url
string
Filter comments by a specific page URL.
​
status
string
Filter by status: OPEN, RESOLVED, IN_PROGRESS, or CLOSED.
​
priority
string
Filter by priority: LOW, MEDIUM, HIGH, or URGENT.
​
assigned_to
string
UUID of the user the comments are assigned to.
​
per_page
integer
Results per page. Default: 25. Max: 100.
​
page
integer
Page number. Default: 1.
{
  "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
  }
}