Skip to main content
POST
/
v1
/
public
/
feedbacks.list
curl --location --request POST 'https://api.yourapp.com/v1/public/feedbacks.list?sortBy=top&limit=10' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json'

{
  "data": [
    {
      "id": "22222222-1234-1234-1234-123456789012",
      "urlId": "abc123def456",
      "url": "/add-dark-mode-support-abc123def456",
      "title": "Add dark mode support",
      "text": "It would be great to have a dark mode option.",
      "status": "in_review",
      "priority": "medium",
      "boardId": "33333333-1234-1234-1234-123456789012",
      "creatorId": "87654321-1234-1234-1234-123456789012",
      "teamId": "11111111-1234-1234-1234-123456789012",
      "feedbackVotesCount": 42,
      "feedbackCommentsCount": 8,
      "publishedAt": "2024-01-15T10:30:00Z",
      "createdAt": "2024-01-15T10:30:00Z",
      "updatedAt": "2024-01-16T14:20:00Z",
      "archivedAt": null,
      "lastModifiedById": null,
      "meta": {},
      "subscriber": {
        "id": "87654321-1234-1234-1234-123456789012",
        "name": "John Doe",
        "email": "john@example.com"
      },
      "lastModifiedBy": null,
      "tags": [
        {
          "id": "tag-uuid",
          "name": "UI/UX",
          "color": "#3B82F6"
        }
      ]
    }
  ],
  "pagination": {
    "offset": 0,
    "limit": 20,
    "count": 156
  }
}

​
Authentication

This endpoint requires API key authentication via the Authorization header. 
Authorization: Bearer YOUR_API_KEY

​
Query Parameters

​
sortBy
string
default:"newest"
Sorting method:
  • newest - Most recently updated (default)
  • top - Most votes overall
  • trending - Most activity in last 7 days (votes + comments)
​
status
string
Filter by status:
  • in_review
  • in_progress
  • planned
  • completed
  • closed
​
boardId
string
Filter by feedback board UUID
​
search
string
Search in feedback text (case-insensitive)
​
limit
number
default:"20"
Maximum number of results (1-100)
​
offset
number
default:"0"
Number of results to skip for pagination

​
Response

​
data
array
Array of feedback objects
​
pagination
object
curl --location --request POST 'https://api.yourapp.com/v1/public/feedbacks.list?sortBy=top&limit=10' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json'

{
  "data": [
    {
      "id": "22222222-1234-1234-1234-123456789012",
      "urlId": "abc123def456",
      "url": "/add-dark-mode-support-abc123def456",
      "title": "Add dark mode support",
      "text": "It would be great to have a dark mode option.",
      "status": "in_review",
      "priority": "medium",
      "boardId": "33333333-1234-1234-1234-123456789012",
      "creatorId": "87654321-1234-1234-1234-123456789012",
      "teamId": "11111111-1234-1234-1234-123456789012",
      "feedbackVotesCount": 42,
      "feedbackCommentsCount": 8,
      "publishedAt": "2024-01-15T10:30:00Z",
      "createdAt": "2024-01-15T10:30:00Z",
      "updatedAt": "2024-01-16T14:20:00Z",
      "archivedAt": null,
      "lastModifiedById": null,
      "meta": {},
      "subscriber": {
        "id": "87654321-1234-1234-1234-123456789012",
        "name": "John Doe",
        "email": "john@example.com"
      },
      "lastModifiedBy": null,
      "tags": [
        {
          "id": "tag-uuid",
          "name": "UI/UX",
          "color": "#3B82F6"
        }
      ]
    }
  ],
  "pagination": {
    "offset": 0,
    "limit": 20,
    "count": 156
  }
}

​
Sorting Algorithms

​
Top

Sorts by total vote count (all-time). Use for “most popular” or “most requested” views. Sorts by recent activity (votes + comments in last 7 days). Use for “hot” or “trending now” views.

​
Newest

Sorts by most recent update. Use for “latest feedback” or chronological views.

​
Use Cases

  • Public Feedback Portal: Display all feedback to users
  • Feature Voting Board: Show top-voted features
  • Trending Ideas: Highlight gaining traction
  • Search: Find specific feedback
  • Board-Specific Views: Filter by board for categorization

​
Notes

  • Only returns feedback from public boards
  • Archived feedback is excluded
  • Search is case-insensitive and searches the text field
  • Pagination is recommended for large datasets
  • Vote and comment counts are calculated in real-time
  • Default sort is by updatedAt DESC (most recently updated)