GET/projects/{project_id}/ideas

List ideas

Retrieve a paginated list of ideas for a specific project with optional filtering. All statuses are returned (including Pending, Rejected) — unlike the public widget endpoint which only shows publicly visible statuses.

Base URLhttps://seggwat.com/api/v1

Parameters

project_idpathstringrequired

Unique identifier of the project (MongoDB ObjectId)

Example: 507f1f77bcf86cd799439011

pagequeryinteger

Page number (1-indexed)

limitqueryinteger

Number of items per page

statusqueryIdeaStatus

Filter by idea status

tag_idquerystring

Filter by tag identifier

searchquerystring

Search term to filter ideas by title or description

sort_by_votesqueryboolean

Sort results by vote count descending

Responses

Request

GET/projects/{project_id}/ideas

curl \
  "https://seggwat.com/api/v1/projects/string/ideas?page=1&limit=20&status=Pending&tag_id=string&search=string&sort_by_votes=true"

Response

200application/json

{
  "ideas": [
    {
      "admin_response": "Great idea! We have this on our roadmap for Q2.",
      "archived": false,
      "comments_count": 7,
      "created_at": "2024-01-15T10:30:00Z",
      "description": "Users have requested a dark theme for nighttime use to reduce eye strain",
      "id": "507f1f77bcf86cd799439011",
      "merged_into_id": "string",
      "project_id": "507f1f77bcf86cd799439022",
      "status": "Pending",
      "submitted_by": "user_12345",
      "submitted_by_email": "customer@example.com",
      "tag_ids": [
        "507f1f77bcf86cd799439050"
      ],
      "title": "Add dark mode support",
      "updated_at": "2024-01-20T14:00:00Z",
      "votes_count": 42
    }
  ],
  "pagination": {
    "limit": 20,
    "page": 1,
    "total": 42,
    "total_pages": 3
  }
}

Navigation