API Reference

REST API for programmatic access to feedback data.

Base URL

https://api.feedboon.com/v1

Authentication

All API requests require an API key passed in the Authorization header:

Authorization: Bearer fbk_your_api_key

Create API keys in the Feedboon dashboard under Account → API Keys.

Endpoints

GET/v1/projects

List all projects accessible to the authenticated user.

GET/v1/feedback

List feedback items with optional status, priority, and project filters.

POST/v1/feedback

Submit new feedback (used by the widget).

GET/v1/feedback/:id

Get detailed feedback including metadata, console errors, and AI analysis.

PATCH/v1/feedback/:id

Update feedback status, priority, or assignee.

POST/v1/feedback/:id/comments

Add a comment to a feedback item.

GET/v1/pins

Get all pins for a specific page URL (used by the widget).

Example request

Terminal

curl -X GET https://api.feedboon.com/v1/feedback \
  -H "Authorization: Bearer fbk_your_api_key" \
  -H "Content-Type: application/json"

Response

response.json

{
  "data": [
    {
      "id": "FB-007",
      "title": "Button broken",
      "status": "new",
      "priority": "high",
      "page_url": "/checkout",
      "browser": "Chrome 120",
      "has_screenshot": true,
      "has_console_errors": true,
      "created_at": "2026-01-25T10:30:00Z"
    }
  ],
  "pagination": {
    "total": 1,
    "page": 1,
    "per_page": 20
  }
}

Rate limits

API requests are limited to 100 requests per minute per API key. Rate limit headers are included in all responses:

Header	Description
X-RateLimit-Limit	Max requests per minute
X-RateLimit-Remaining	Remaining requests in current window
X-RateLimit-Reset	Seconds until rate limit resets