Skip to main content
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 to find the botId to pass as {id}.
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.

​
Reference pages

Get agent analytics

GET /v2/bots/{id}/hc-analytics/public - return the full analytics summary for one agent.

Get agent analytics section

GET /v2/bots/{id}/hc-analytics/{section}/public - return one analytics section.

​
Endpoint map

​
Query model

Both endpoints use the same filter model: Use Get agent analytics when you need the complete payload. Use Get agent analytics section when you only need summary, trends, knowledge, rules, or escalations.