Analytics
Get agent analytics
Fetch the full analytics summary for one agent.
GET
Returns analytics for one agent over a requested time window. The response includes summary metrics, comparison metrics, chart datasets, knowledge usage, rule analytics, escalation reasons, hourly volume, and CSAT data when available.
Use this route when you need the complete analytics payload. If you only need one part of the payload, use Get agent analytics section. For the analytics endpoint family, see Analytics.
Headers
string
required
Bearer token containing your Fini workspace API key. Format:
Bearer fini_... The key needs read scope.Path parameters
string
required
Agent ID whose analytics you want to read. Use List agents to get the
botId.Query parameters
number
required
Start of the analytics window as a Unix epoch timestamp.
number
required
End of the analytics window as a Unix epoch timestamp.
string | string[]
Conversation source filter. Pass
all to include all supported sources, or pass one or more source values accepted by Fini.string | string[]
Optional channel filter.
string | string[]
Optional latest-status filter.
string | string[]
Optional latest-sentiment filter.
string | string[]
Optional knowledge subfolder IDs to filter by.
string | string[]
Optional tag IDs to filter by.
string | string[]
Optional rule IDs to filter by.
string | string[]
Optional escalation-reason tag IDs to filter by.
number | number[]
Optional CSAT ratings to filter by. Values must be integers from
1 through 5.string
Optional timezone used for date grouping.
Response
Returns anAgentAnalyticsSummary object.
AnalyticsMetrics
Current-window totals and rates.
AnalyticsMetrics
Comparison-window totals and rates.
object
Metric-card values for conversation volume, AI resolution rate, human escalation rate, average response time, and average CSAT rating.
array
Conversation counts grouped by status.
array
Conversation counts and resolved counts grouped by channel.
array
Daily resolved, escalated, and waiting-for-customer counts.
array
Daily total conversations, resolved conversations, and AI resolution rate.
array
Daily average first-response time in milliseconds.
object
Current and comparison knowledge-folder usage arrays.
array
Rule-level conversation, resolution, escalation, and CSAT metrics.
array
Escalation-reason tag counts.
array
Volume by day of week and hour.
array
Optional daily CSAT percentage chart data.
AnalyticsMetrics object
number
Total conversations in the window.
number
Conversations resolved by AI.
number
Conversations escalated to a human.
number
Conversations waiting for the customer.
number
AI resolution rate for the window.
number
Human escalation rate for the window.
number
Average response time in milliseconds.
number
Average CSAT rating.
Errors
400 Bad Request
400 Bad Request
The path ID or query parameters are invalid.
startEpoch and endEpoch are required.403 Forbidden
403 Forbidden
The API key does not include the
read scope required for this route.406 Not Acceptable
406 Not Acceptable
The agent belongs to a different workspace.
500 Internal Server Error
500 Internal Server Error
Fini failed while loading analytics.

