Skip to main content

​
List feature requests

GET /api/v1/feedback/features

​
Headers

HeaderRequiredDescription
X-Bundle-IDYesApp bundle identifier
X-Team-IDYesApple Developer Team ID

​
Query parameters

ParameterTypeDefaultDescription
pageint1Page number
perint20Results per page (max 100)
sortstring—newest, oldest, or most_voted
statusstring—Filter by status
voter_idstring—Check if this user has voted

​
Response

{
  "items": [
    {
      "id": "uuid",
      "title": "Dark Mode Support",
      "description": "Please add dark mode...",
      "status": "open",
      "voteCount": 42,
      "hasVoted": true,
      "commentCount": 5,
      "createdAt": "2025-03-01T12:00:00Z",
      "updatedAt": "2025-03-10T08:00:00Z"
    }
  ],
  "metadata": {
    "page": 1,
    "per": 20,
    "total": 42
  }
}

​
Create feature request

POST /api/v1/feedback/features

​
Body

{
  "title": "Dark Mode Support",
  "description": "Please add a dark mode option to reduce eye strain at night.",
  "submitterId": "user_123",
  "deviceHash": "optional-device-hash"
}
FieldTypeRequiredDescription
titlestringYes3–200 characters
descriptionstringYes10–5,000 characters
submitterIdstringYesUser or device identifier
deviceHashstringNoDevice hash for deduplication

​
Response

Returns the created feature request object.

​
Get feature request

GET /api/v1/feedback/features/:featureId

​
Query parameters

ParameterTypeDescription
voter_idstringCheck if this user has voted

​
Response

Returns a single feature request object.