> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usefini.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Fetch performance summaries, chart datasets, knowledge usage, rules performance, and escalation breakdowns for one agent.

Analytics endpoints return reporting data for one agent over a requested time window. Use them to export the same core metrics the dashboard uses: conversation volume, resolution rate, response time, knowledge usage, rule performance, escalation reasons, hourly volume, and CSAT data when available.

The API paths are scoped by agent ID because analytics are calculated for one workspace agent at a time. Use [List agents](/en/api-reference/list-agents) to find the `botId` to pass as `{id}`.

<Info>
  In the dashboard and most docs, these entities are called **agents**. In public API paths and some response fields, the same entity appears as **bot**.
</Info>

## Reference pages

<CardGroup cols={2}>
  <Card title="Get agent analytics" icon="chart-line" href="/en/api-reference/get-agent-analytics">
    `GET /v2/bots/{id}/hc-analytics/public` - return the full analytics summary for one agent.
  </Card>

  <Card title="Get agent analytics section" icon="chart-simple" href="/en/api-reference/get-agent-analytics-section">
    `GET /v2/bots/{id}/hc-analytics/{section}/public` - return one analytics section.
  </Card>
</CardGroup>

## Endpoint map

| Method | Path                                        | Scope  | Purpose                                     |
| ------ | ------------------------------------------- | ------ | ------------------------------------------- |
| `GET`  | `/v2/bots/:id/hc-analytics/public`          | `read` | Fetch all analytics sections for one agent. |
| `GET`  | `/v2/bots/:id/hc-analytics/:section/public` | `read` | Fetch one analytics section for one agent.  |

## Query model

Both endpoints use the same filter model:

| Query                    | Required | Purpose                                                                  |
| ------------------------ | -------- | ------------------------------------------------------------------------ |
| `startEpoch`             | Yes      | Start of the analytics window as a Unix epoch timestamp.                 |
| `endEpoch`               | Yes      | End of the analytics window as a Unix epoch timestamp.                   |
| `source`                 | No       | Conversation source filter. Pass `all` to include all supported sources. |
| `channel`                | No       | Channel filter.                                                          |
| `latestStatus`           | No       | Latest conversation status filter.                                       |
| `latestSentiment`        | No       | Latest sentiment filter.                                                 |
| `usedSubfolderIds`       | No       | Knowledge subfolder filter.                                              |
| `tagIds`                 | No       | Tag filter.                                                              |
| `ruleIds`                | No       | Rule filter.                                                             |
| `escalationReasonTagIds` | No       | Escalation-reason tag filter.                                            |
| `csatRatings`            | No       | CSAT rating filter. Values must be integers from `1` through `5`.        |
| `timezone`               | No       | Timezone used for date grouping.                                         |

Use [Get agent analytics](/en/api-reference/get-agent-analytics) when you need the complete payload. Use [Get agent analytics section](/en/api-reference/get-agent-analytics-section) when you only need `summary`, `trends`, `knowledge`, `rules`, or `escalations`.