# Get feedback (/api/analytics/feedback)

<!-- agent-signals: reading_time_min: 6 · est_tokens: 3788 · updated: 2026-07-30 -->
Related: [Get feedback by page](/api/analytics/feedback-by-page.md), [Get assistant conversations](/api/analytics/assistant-conversations.md), [Get assistant caller stats](/api/analytics/assistant-caller-stats.md), [Get search queries](/api/analytics/searches.md), [Get page views](/api/analytics/views.md), [Get unique visitors](/api/analytics/visitors.md)

## Usage [#usage]

Use this endpoint to export user feedback collected from your documentation. Feedback includes contextual feedback from page ratings, code snippet feedback, and agent feedback.

Paginate through results using the `cursor` parameter returned in the response. Continue fetching while `hasMore` is `true`.

## Filtering [#filtering]

Filter feedback by:

* **Date range**: Use `dateFrom` and `dateTo` to limit results to a specific time period
* **Source**: Filter by `code_snippet`, `contextual`, or `agent` feedback types
* **Status**: Filter by status values like `pending`, `in_progress`, `resolved`, or `dismissed`

## Response types [#response-types]

The response contains different feedback types based on the source:

* **Contextual feedback**: Includes `helpful` boolean and optional `contact` email
* **Code snippet feedback**: Includes `code`, `filename`, and `lang` fields
* **Agent feedback**: Includes a `comment` with the agent's feedback text and the `path` of the page it relates to

## Rate limits [#rate-limits]

This endpoint allows 100 requests per organization per hour. All analytics endpoints share this limit.

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

Returns paginated user feedback with optional filtering

Authenticate with an admin API key.

## OpenAPI

```json
{
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "parameters": [
    {
      "schema": {
        "type": "string",
        "description": "Your project ID. Can be copied from the [API keys](https://app.mintlify.com/settings/organization/api-keys) page in your dashboard."
      },
      "required": true,
      "name": "projectId",
      "in": "path"
    },
    {
      "schema": {
        "type": "string",
        "description": "Date in ISO 8601 or YYYY-MM-DD format",
        "example": "2024-01-01"
      },
      "required": false,
      "name": "dateFrom",
      "in": "query"
    },
    {
      "schema": {
        "type": "string",
        "description": "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.",
        "example": "2024-01-01"
      },
      "required": false,
      "name": "dateTo",
      "in": "query"
    },
    {
      "schema": {
        "type": "string",
        "enum": [
          "code_snippet",
          "contextual",
          "agent",
          "thumbs_only"
        ],
        "description": "Filter by feedback source"
      },
      "required": false,
      "name": "source",
      "in": "query"
    },
    {
      "schema": {
        "type": "string",
        "description": "Comma-separated list of statuses to filter by"
      },
      "required": false,
      "name": "status",
      "in": "query"
    },
    {
      "schema": {
        "type": "number",
        "minimum": 1,
        "maximum": 100,
        "default": 50,
        "description": "Max results per page"
      },
      "required": false,
      "name": "limit",
      "in": "query"
    },
    {
      "schema": {
        "type": "string",
        "description": "Pagination cursor"
      },
      "required": false,
      "name": "cursor",
      "in": "query"
    }
  ],
  "responses": {
    "200": {
      "description": "Feedback data with pagination",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "feedback": {
                "type": "array",
                "description": "List of feedback entries.",
                "items": {
                  "anyOf": [
                    {
                      "description": "Returned when source is `contextual`. Includes whether the user found the page helpful and an optional contact email.",
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "description": "Unique feedback identifier."
                        },
                        "path": {
                          "type": "string",
                          "description": "The path or URL to the source document."
                        },
                        "comment": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "Text of the user's feedback comment."
                        },
                        "createdAt": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "Timestamp when the feedback was submitted."
                        },
                        "source": {
                          "type": "string",
                          "enum": [
                            "code_snippet",
                            "contextual",
                            "agent",
                            "thumbs_only"
                          ],
                          "description": "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": {
                          "type": "string",
                          "enum": [
                            "pending",
                            "in_progress",
                            "resolved",
                            "dismissed"
                          ],
                          "description": "Current review status of the feedback."
                        },
                        "helpful": {
                          "type": "boolean",
                          "description": "Whether the user found the content helpful."
                        },
                        "contact": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "Email address the user provided for follow-up."
                        }
                      },
                      "required": [
                        "id",
                        "path",
                        "comment",
                        "createdAt",
                        "source",
                        "status",
                        "helpful",
                        "contact"
                      ]
                    },
                    {
                      "description": "Returned when source is `code_snippet`. Includes the code, filename, and language of the snippet the feedback relates to.",
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "description": "Unique feedback identifier."
                        },
                        "path": {
                          "type": "string",
                          "description": "The path or URL to the source document."
                        },
                        "comment": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "Text of the user's feedback comment."
                        },
                        "createdAt": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "Timestamp when the feedback was submitted."
                        },
                        "source": {
                          "type": "string",
                          "enum": [
                            "code_snippet",
                            "contextual",
                            "agent",
                            "thumbs_only"
                          ],
                          "description": "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": {
                          "type": "string",
                          "enum": [
                            "pending",
                            "in_progress",
                            "resolved",
                            "dismissed"
                          ],
                          "description": "Current review status of the feedback."
                        },
                        "code": {
                          "type": "string",
                          "description": "The code snippet the feedback relates to."
                        },
                        "filename": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "Filename associated with the code snippet."
                        },
                        "lang": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "Programming language of the code snippet."
                        }
                      },
                      "required": [
                        "id",
                        "path",
                        "comment",
                        "createdAt",
                        "source",
                        "status",
                        "code",
                        "filename",
                        "lang"
                      ]
                    },
                    {
                      "description": "Returned when source is `agent` or `thumbs_only`. Contains base feedback fields only.",
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "description": "Unique feedback identifier."
                        },
                        "path": {
                          "type": "string",
                          "description": "The path or URL to the source document."
                        },
                        "comment": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "Text of the user's feedback comment."
                        },
                        "createdAt": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "Timestamp when the feedback was submitted."
                        },
                        "source": {
                          "type": "string",
                          "enum": [
                            "code_snippet",
                            "contextual",
                            "agent",
                            "thumbs_only"
                          ],
                          "description": "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": {
                          "type": "string",
                          "enum": [
                            "pending",
                            "in_progress",
                            "resolved",
                            "dismissed"
                          ],
                          "description": "Current review status of the feedback."
                        }
                      },
                      "required": [
                        "id",
                        "path",
                        "comment",
                        "createdAt",
                        "source",
                        "status"
                      ]
                    }
                  ]
                }
              },
              "nextCursor": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Cursor to retrieve the next page of results. Null if no more results."
              },
              "hasMore": {
                "type": "boolean",
                "description": "Whether additional results are available beyond this page."
              }
            },
            "required": [
              "feedback",
              "nextCursor",
              "hasMore"
            ]
          }
        }
      }
    },
    "400": {
      "description": "Invalid query parameters",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "error": {
                "type": "string",
                "description": "Error message describing what went wrong."
              },
              "details": {
                "type": "array",
                "description": "Additional details about the error.",
                "items": {
                  "type": "object",
                  "properties": {
                    "message": {
                      "type": "string",
                      "description": "Description of a specific validation or processing error."
                    }
                  },
                  "required": [
                    "message"
                  ]
                }
              }
            },
            "required": [
              "error"
            ]
          }
        }
      }
    },
    "500": {
      "description": "Server error",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "error": {
                "type": "string",
                "description": "Error message describing what went wrong."
              },
              "details": {
                "type": "array",
                "description": "Additional details about the error.",
                "items": {
                  "type": "object",
                  "properties": {
                    "message": {
                      "type": "string",
                      "description": "Description of a specific validation or processing error."
                    }
                  },
                  "required": [
                    "message"
                  ]
                }
              }
            },
            "required": [
              "error"
            ]
          }
        }
      }
    }
  }
}
```