curl --location --request POST 'https://api.userorbit.com/v1/public/feedbacks.list?sortBy=top&limit=10' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json'
curl --location --request POST 'https://api.userorbit.com/v1/public/feedbacks.list?search=dark%20mode&status=in_review' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json'
const response = await fetch(
'https://api.userorbit.com/v1/public/feedbacks.list?sortBy=trending&limit=20',
{
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
}
}
);
const data = await response.json();
import requests
response = requests.post(
'https://api.userorbit.com/v1/public/feedbacks.list',
params={
'sortBy': 'top',
'status': 'in_review',
'limit': 20
},
headers={
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
}
)
data = response.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
}
}
Management
List Feedback (Public)
List feedback with advanced filtering and sorting. Returns feedback from public boards.
POST
/
v1
/
public
/
feedbacks.list
curl --location --request POST 'https://api.userorbit.com/v1/public/feedbacks.list?sortBy=top&limit=10' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json'
curl --location --request POST 'https://api.userorbit.com/v1/public/feedbacks.list?search=dark%20mode&status=in_review' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json'
const response = await fetch(
'https://api.userorbit.com/v1/public/feedbacks.list?sortBy=trending&limit=20',
{
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
}
}
);
const data = await response.json();
import requests
response = requests.post(
'https://api.userorbit.com/v1/public/feedbacks.list',
params={
'sortBy': 'top',
'status': 'in_review',
'limit': 20
},
headers={
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
}
)
data = response.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 theAuthorization header.
Authorization: Bearer YOUR_API_KEY
Query Parameters
string
default:"newest"
Sorting method:
newest- Most recently updated (default)top- Most votes overalltrending- Most activity in last 7 days (votes + comments)
string
Filter by status:
in_reviewin_progressplannedcompletedclosed
string
Filter by feedback board UUID
string
Search in feedback text (case-insensitive)
number
default:"20"
Maximum number of results (1-100)
number
default:"0"
Number of results to skip for pagination
Response
array
Array of feedback objects
Show Feedback Object
Show Feedback Object
curl --location --request POST 'https://api.userorbit.com/v1/public/feedbacks.list?sortBy=top&limit=10' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json'
curl --location --request POST 'https://api.userorbit.com/v1/public/feedbacks.list?search=dark%20mode&status=in_review' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json'
const response = await fetch(
'https://api.userorbit.com/v1/public/feedbacks.list?sortBy=trending&limit=20',
{
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
}
}
);
const data = await response.json();
import requests
response = requests.post(
'https://api.userorbit.com/v1/public/feedbacks.list',
params={
'sortBy': 'top',
'status': 'in_review',
'limit': 20
},
headers={
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
}
)
data = response.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.Trending
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
textfield - Pagination is recommended for large datasets
- Vote and comment counts are calculated in real-time
- Default sort is by
updatedAt DESC(most recently updated)
Was this page helpful?

