# GET `/api/v1/feedback`

> Part of the `Buuk Public API` API reference.

**List reader feedback**

Up/down feedback from readers of the help center, newest first. Scope: help_center:read.

Base URL: `https://app.getbuuk.com`

## Authentication

Authentication:
  - `apiToken` — HTTP BEARER

## Parameters

- `limit` — integer (query, optional)
- `rating` — string (query, optional)
- `Buuk-Version` — string (header, optional) — API version to use. Omit for the current version (1). Unsupported values return 400 unsupported_api_version.

## Responses

### 200 — Feedback entries.

- `count` — integer
- `feedback` — array<object>
  - `id` — string·uuid
  - `rating` — string — enum: "up" | "down"
  - `article` — object
  - `id` — string
  - `slug` — string
  - `title` — string
  - `comment` — string
  - `createdAt` — string·date-time

### 401 — Missing or invalid token.

- `error` — string — required — Stable machine-readable error code, e.g. unauthorized, forbidden, invalid_request, not_found, rate_limited.
- `details` — object — Field-level validation failures, present only for invalid_request.
- `message` — string — Human-readable problem description.

### 403 — Token lacks help_center:read.

- `error` — string — required — Stable machine-readable error code, e.g. unauthorized, forbidden, invalid_request, not_found, rate_limited.
- `details` — object — Field-level validation failures, present only for invalid_request.
- `message` — string — Human-readable problem description.

### 429 — Rate limit exceeded. Retry-After header carries the wait in seconds.

- `error` — string — required — Stable machine-readable error code, e.g. unauthorized, forbidden, invalid_request, not_found, rate_limited.
- `details` — object — Field-level validation failures, present only for invalid_request.
- `message` — string — Human-readable problem description.

---

View in browser: /help/buuk/reference/d53aa94b-580c-4d39-b806-08b3068b6215
Generated from the `Buuk Public API` reference for `buuk`.