---
title: "Get user feedback"
method: GET
path: "/v1/analytics/{projectId}/feedback"
tags: ["Analytics"]
---

# Get user feedback

`GET /v1/analytics/{projectId}/feedback`

Returns paginated user feedback with optional filtering

Authenticate with an admin API key.

## Path parameters

- `projectId` string, required — Your project ID. Can be copied from the [API keys](https://app.mintlify.com/settings/organization/api-keys) page in your dashboard.

## Query parameters

- `dateFrom` string — Date in ISO 8601 or YYYY-MM-DD format
- `dateTo` string — Date in ISO 8601 or YYYY-MM-DD format. `dateTo` is an exclusive upper limit. Results include dates before, but not on, the specified date.
- `source` 'code_snippet' | 'contextual' | 'agent' | 'thumbs_only' — Filter by feedback source
- `status` string — Comma-separated list of statuses to filter by
- `limit` number — Max results per page
- `cursor` string — Pagination cursor

## Response `200`

Feedback data with pagination

- FeedbackResponse
  - `feedback` union[], required — List of feedback entries.
    - union
      - object — Returned when source is `contextual`. Includes whether the user found the page helpful and an optional contact email.
        - `id` string, required — Unique feedback identifier.
        - `path` string, required — The path or URL to the source document.
        - `comment` unknown, required
        - `createdAt` unknown, required
        - `source` 'code_snippet' | 'contextual' | 'agent' | 'thumbs_only', required — Where the feedback originated. `code_snippet` is feedback on a code block, `contextual` is page-level feedback, `agent` is feedback submitted by a third-party AI agent, `thumbs_only` is a thumbs up/down vote.
        - `status` 'pending' | 'in_progress' | 'resolved' | 'dismissed', required — Current review status of the feedback.
        - `helpful` boolean, required — Whether the user found the content helpful.
        - `contact` unknown, required
      - object — Returned when source is `code_snippet`. Includes the code, filename, and language of the snippet the feedback relates to.
        - `id` string, required — Unique feedback identifier.
        - `path` string, required — The path or URL to the source document.
        - `comment` unknown, required
        - `createdAt` unknown, required
        - `source` 'code_snippet' | 'contextual' | 'agent' | 'thumbs_only', required — Where the feedback originated. `code_snippet` is feedback on a code block, `contextual` is page-level feedback, `agent` is feedback submitted by a third-party AI agent, `thumbs_only` is a thumbs up/down vote.
        - `status` 'pending' | 'in_progress' | 'resolved' | 'dismissed', required — Current review status of the feedback.
        - `code` string, required — The code snippet the feedback relates to.
        - `filename` unknown, required
        - `lang` unknown, required
      - object — Returned when source is `agent` or `thumbs_only`. Contains base feedback fields only.
        - `id` string, required — Unique feedback identifier.
        - `path` string, required — The path or URL to the source document.
        - `comment` unknown, required
        - `createdAt` unknown, required
        - `source` 'code_snippet' | 'contextual' | 'agent' | 'thumbs_only', required — Where the feedback originated. `code_snippet` is feedback on a code block, `contextual` is page-level feedback, `agent` is feedback submitted by a third-party AI agent, `thumbs_only` is a thumbs up/down vote.
        - `status` 'pending' | 'in_progress' | 'resolved' | 'dismissed', required — Current review status of the feedback.
  - `nextCursor` unknown, required
  - `hasMore` boolean, required — Whether additional results are available beyond this page.

## Other responses

- `400` — Invalid query parameters
- `500` — Server error

---

[API](https://skmtc.dev/mcp-b/apis/mintlify-admin-api.md) · [All operations](https://skmtc.dev/mcp-b/apis/mintlify-admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/mcp-b/mintlify-admin-api/revisions/6165028f8792/schema)