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

# Get conversation analytics.

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

## Request

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

Returns conversation metrics, including total conversations, average duration, messages per conversation, and completion rates. Use this to understand how users engage with your agent.

## Path parameters

- `projectId` integer, required

## Query parameters

- `filters` string[], required

## Response `200`

Get the conversation metrics data for an agent

- object
  - `status` 'error' | 'success': The status of the response
  - `data` ProjectAnalyticsConversation
    - `total` integer: Total number of conversations
    - `average_queries_per_conversation` integer: Average number of queries per conversations

## 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/conversations/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)