---
title: "Get query analytics."
method: GET
path: "/api/v1/projects/{projectId}/reports/queries"
tags: ["Reports & Analytics"]
---

# Get query analytics.

`GET /api/v1/projects/{projectId}/reports/queries`

## Request

- Base URL: `https://app.customgpt.ai`
- URL: `https://app.customgpt.ai/api/v1/projects/{projectId}/reports/queries`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/poll-the-people/apis/customgpt-ai/docs/api/v1/projects/:projectId/reports/queries/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns aggregate query metrics, including total query volume, success rates, average response times, and failure reasons. Use this to monitor agent performance and identify issues.

## Path parameters

- `projectId` integer, required

## Query parameters

- `filters` string[], required

## Response `200`

Get the query metrics for an agent

- object
  - `status` 'error' | 'success': The status of the response
  - `data` ProjectAnalyticsQuery
    - `total` integer: Total number of queries over all conversations
    - `query_status` object[]: Number of successful and failed queries over all conversations
      - `status` 'failed' | 'success': The resolution status of this query group.
      - `count` integer: The number of queries with this status in the selected time period.

## Other responses

- `400`: Bad Argument
- `401`: API Token is either missing or invalid
- `404`: Agent not found
- `429`: Too many requests. You have exceeded your API rate limit.
- `500`: Internal Server Error

## Changes

- **2026-11-03** `77aab4354382`: 4 warning, 1 info
  - added the new `422.00` enum value to the `data/code` response property for the response status `400`
  - added the new `422.00` enum value to the `data/code` response property for the response status `401`
  - added the new `422.00` enum value to the `data/code` response property for the response status `404`
  - added the new `422.00` enum value to the `data/code` response property for the response status `500`
  - …1 more
- **2026-07-17** `b80e6dfcf78d`: 1 info
  - endpoint added
- **2023-06-02** `1842d7fd0430`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/poll-the-people/apis/customgpt-ai/changes/api/v1/projects/:projectId/reports/queries/get.md)

---

[API](https://skmtc.dev/poll-the-people/apis/customgpt-ai.md) - [All operations](https://skmtc.dev/poll-the-people/apis/customgpt-ai/llms.txt) - [OpenAPI document](https://skmtc.dev/poll-the-people/apis/customgpt-ai/revisions/77aab4354382?raw)