curl --request GET \
--url 'https://api-prod.usefini.com/v2/bots/4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3/hc-analytics/public?startEpoch=1784073600000&endEpoch=1784678400000&source=all' \
--header 'Authorization: Bearer fini_your_api_key'
import requests
response = requests.get(
"https://api-prod.usefini.com/v2/bots/4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3/hc-analytics/public",
headers={"Authorization": "Bearer fini_your_api_key"},
params={
"startEpoch": 1784073600000,
"endEpoch": 1784678400000,
"source": "all",
},
)
analytics = response.json()
const params = new URLSearchParams({
startEpoch: "1784073600000",
endEpoch: "1784678400000",
source: "all",
});
const response = await fetch(
`https://api-prod.usefini.com/v2/bots/4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3/hc-analytics/public?${params.toString()}`,
{
headers: {
Authorization: "Bearer fini_your_api_key",
},
}
);
const analytics = await response.json();
{
"summary": {
"totalConversations": 100,
"resolvedConversations": 70,
"escalatedConversations": 20,
"waitingForCustomerConversations": 10,
"aiResolutionRate": 70,
"humanEscalationRate": 20,
"averageResponseTimeMs": 2400,
"medianResponseTimeMs": 1800,
"averageCsatRating": 4
},
"comparisonSummary": {
"totalConversations": 100,
"resolvedConversations": 70,
"escalatedConversations": 20,
"waitingForCustomerConversations": 10,
"aiResolutionRate": 70,
"humanEscalationRate": 20,
"averageResponseTimeMs": 2400,
"medianResponseTimeMs": 1800,
"averageCsatRating": 4
},
"summaryCards": {
"conversationVolume": {
"currentValue": 100,
"comparisonValue": 100,
"absoluteChange": 0,
"percentChange": 0,
"changeDirection": "neutral",
"performance": "neutral",
"isAvailable": true
},
"aiResolutionRate": {
"currentValue": 70,
"comparisonValue": 70,
"absoluteChange": 0,
"percentChange": 0,
"changeDirection": "neutral",
"performance": "neutral",
"isAvailable": true
},
"humanEscalationRate": {
"currentValue": 20,
"comparisonValue": 20,
"absoluteChange": 0,
"percentChange": 0,
"changeDirection": "neutral",
"performance": "neutral",
"isAvailable": true
},
"averageResponseTime": {
"currentValue": 2400,
"comparisonValue": 2400,
"absoluteChange": 0,
"percentChange": 0,
"changeDirection": "neutral",
"performance": "neutral",
"isAvailable": true
},
"medianResponseTime": {
"currentValue": 1800,
"comparisonValue": 1800,
"absoluteChange": 0,
"percentChange": 0,
"changeDirection": "neutral",
"performance": "neutral",
"isAvailable": true
},
"averageCsatRating": {
"currentValue": 80,
"comparisonValue": 80,
"absoluteChange": 0,
"percentChange": 0,
"changeDirection": "neutral",
"performance": "neutral",
"isAvailable": true
}
},
"statusBreakdown": [
{
"status": "Resolved by AI",
"count": 70
},
{
"status": "Escalated to Human Agent",
"count": 20
},
{
"status": "Waiting for Customer",
"count": 10
}
],
"usageByChannel": [
{
"channel": "chat",
"count": 100,
"resolved": 70
}
],
"conversationVolumeChartData": [
{
"day": "2026-07-15",
"resolved": 70,
"escalated": 20,
"waitingForCustomer": 10
}
],
"resolutionRateChartData": [
{
"day": "2026-07-15",
"totalConversations": 100,
"resolvedConversations": 70,
"aiResolutionRate": 70
}
],
"responseTimeChartData": [
{
"day": "2026-07-15",
"averageResponseTimeMs": 2400,
"medianResponseTimeMs": 1800
}
],
"knowledgeUsage": {
"current": [
{
"folderId": "4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3",
"total": 100,
"resolved": 70,
"escalated": 20,
"averageCsatPercentage": 80,
"ratedConversations": 10
}
],
"comparison": [
{
"folderId": "4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3",
"total": 100,
"resolved": 70,
"escalated": 20,
"averageCsatPercentage": 80,
"ratedConversations": 10
}
]
},
"ruleAnalytics": [
{
"ruleId": "4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3",
"ruleName": "Order status",
"totalConversations": 100,
"resolvedConversations": 70,
"aiResolutionRate": 70,
"escalatedConversations": 20,
"escalatedRate": 20,
"averageCsatPercentage": 80,
"ratedConversations": 10
}
],
"escalationReasons": [
{
"tagId": "4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3",
"tagName": "Missing Knowledge",
"count": 20
}
],
"hourlyVolume": [
{
"dayOfWeek": 3,
"hour": 12,
"total": 100,
"resolved": 70
}
]
}
Analytics
Get agent analytics
Fetch the full analytics summary for one agent.
GET
/
v2
/
bots
/
{id}
/
hc-analytics
/
public
curl --request GET \
--url 'https://api-prod.usefini.com/v2/bots/4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3/hc-analytics/public?startEpoch=1784073600000&endEpoch=1784678400000&source=all' \
--header 'Authorization: Bearer fini_your_api_key'
import requests
response = requests.get(
"https://api-prod.usefini.com/v2/bots/4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3/hc-analytics/public",
headers={"Authorization": "Bearer fini_your_api_key"},
params={
"startEpoch": 1784073600000,
"endEpoch": 1784678400000,
"source": "all",
},
)
analytics = response.json()
const params = new URLSearchParams({
startEpoch: "1784073600000",
endEpoch: "1784678400000",
source: "all",
});
const response = await fetch(
`https://api-prod.usefini.com/v2/bots/4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3/hc-analytics/public?${params.toString()}`,
{
headers: {
Authorization: "Bearer fini_your_api_key",
},
}
);
const analytics = await response.json();
{
"summary": {
"totalConversations": 100,
"resolvedConversations": 70,
"escalatedConversations": 20,
"waitingForCustomerConversations": 10,
"aiResolutionRate": 70,
"humanEscalationRate": 20,
"averageResponseTimeMs": 2400,
"medianResponseTimeMs": 1800,
"averageCsatRating": 4
},
"comparisonSummary": {
"totalConversations": 100,
"resolvedConversations": 70,
"escalatedConversations": 20,
"waitingForCustomerConversations": 10,
"aiResolutionRate": 70,
"humanEscalationRate": 20,
"averageResponseTimeMs": 2400,
"medianResponseTimeMs": 1800,
"averageCsatRating": 4
},
"summaryCards": {
"conversationVolume": {
"currentValue": 100,
"comparisonValue": 100,
"absoluteChange": 0,
"percentChange": 0,
"changeDirection": "neutral",
"performance": "neutral",
"isAvailable": true
},
"aiResolutionRate": {
"currentValue": 70,
"comparisonValue": 70,
"absoluteChange": 0,
"percentChange": 0,
"changeDirection": "neutral",
"performance": "neutral",
"isAvailable": true
},
"humanEscalationRate": {
"currentValue": 20,
"comparisonValue": 20,
"absoluteChange": 0,
"percentChange": 0,
"changeDirection": "neutral",
"performance": "neutral",
"isAvailable": true
},
"averageResponseTime": {
"currentValue": 2400,
"comparisonValue": 2400,
"absoluteChange": 0,
"percentChange": 0,
"changeDirection": "neutral",
"performance": "neutral",
"isAvailable": true
},
"medianResponseTime": {
"currentValue": 1800,
"comparisonValue": 1800,
"absoluteChange": 0,
"percentChange": 0,
"changeDirection": "neutral",
"performance": "neutral",
"isAvailable": true
},
"averageCsatRating": {
"currentValue": 80,
"comparisonValue": 80,
"absoluteChange": 0,
"percentChange": 0,
"changeDirection": "neutral",
"performance": "neutral",
"isAvailable": true
}
},
"statusBreakdown": [
{
"status": "Resolved by AI",
"count": 70
},
{
"status": "Escalated to Human Agent",
"count": 20
},
{
"status": "Waiting for Customer",
"count": 10
}
],
"usageByChannel": [
{
"channel": "chat",
"count": 100,
"resolved": 70
}
],
"conversationVolumeChartData": [
{
"day": "2026-07-15",
"resolved": 70,
"escalated": 20,
"waitingForCustomer": 10
}
],
"resolutionRateChartData": [
{
"day": "2026-07-15",
"totalConversations": 100,
"resolvedConversations": 70,
"aiResolutionRate": 70
}
],
"responseTimeChartData": [
{
"day": "2026-07-15",
"averageResponseTimeMs": 2400,
"medianResponseTimeMs": 1800
}
],
"knowledgeUsage": {
"current": [
{
"folderId": "4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3",
"total": 100,
"resolved": 70,
"escalated": 20,
"averageCsatPercentage": 80,
"ratedConversations": 10
}
],
"comparison": [
{
"folderId": "4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3",
"total": 100,
"resolved": 70,
"escalated": 20,
"averageCsatPercentage": 80,
"ratedConversations": 10
}
]
},
"ruleAnalytics": [
{
"ruleId": "4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3",
"ruleName": "Order status",
"totalConversations": 100,
"resolvedConversations": 70,
"aiResolutionRate": 70,
"escalatedConversations": 20,
"escalatedRate": 20,
"averageCsatPercentage": 80,
"ratedConversations": 10
}
],
"escalationReasons": [
{
"tagId": "4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3",
"tagName": "Missing Knowledge",
"count": 20
}
],
"hourlyVolume": [
{
"dayOfWeek": 3,
"hour": 12,
"total": 100,
"resolved": 70
}
]
}
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
Inclusive start of the analytics window as a Unix epoch timestamp in milliseconds.
number
required
Exclusive end of the analytics window as a Unix epoch timestamp in milliseconds.
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. Defaults to
UTC. Defaults to UTC.curl --request GET \
--url 'https://api-prod.usefini.com/v2/bots/4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3/hc-analytics/public?startEpoch=1784073600000&endEpoch=1784678400000&source=all' \
--header 'Authorization: Bearer fini_your_api_key'
import requests
response = requests.get(
"https://api-prod.usefini.com/v2/bots/4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3/hc-analytics/public",
headers={"Authorization": "Bearer fini_your_api_key"},
params={
"startEpoch": 1784073600000,
"endEpoch": 1784678400000,
"source": "all",
},
)
analytics = response.json()
const params = new URLSearchParams({
startEpoch: "1784073600000",
endEpoch: "1784678400000",
source: "all",
});
const response = await fetch(
`https://api-prod.usefini.com/v2/bots/4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3/hc-analytics/public?${params.toString()}`,
{
headers: {
Authorization: "Bearer fini_your_api_key",
},
}
);
const analytics = await response.json();
{
"summary": {
"totalConversations": 100,
"resolvedConversations": 70,
"escalatedConversations": 20,
"waitingForCustomerConversations": 10,
"aiResolutionRate": 70,
"humanEscalationRate": 20,
"averageResponseTimeMs": 2400,
"medianResponseTimeMs": 1800,
"averageCsatRating": 4
},
"comparisonSummary": {
"totalConversations": 100,
"resolvedConversations": 70,
"escalatedConversations": 20,
"waitingForCustomerConversations": 10,
"aiResolutionRate": 70,
"humanEscalationRate": 20,
"averageResponseTimeMs": 2400,
"medianResponseTimeMs": 1800,
"averageCsatRating": 4
},
"summaryCards": {
"conversationVolume": {
"currentValue": 100,
"comparisonValue": 100,
"absoluteChange": 0,
"percentChange": 0,
"changeDirection": "neutral",
"performance": "neutral",
"isAvailable": true
},
"aiResolutionRate": {
"currentValue": 70,
"comparisonValue": 70,
"absoluteChange": 0,
"percentChange": 0,
"changeDirection": "neutral",
"performance": "neutral",
"isAvailable": true
},
"humanEscalationRate": {
"currentValue": 20,
"comparisonValue": 20,
"absoluteChange": 0,
"percentChange": 0,
"changeDirection": "neutral",
"performance": "neutral",
"isAvailable": true
},
"averageResponseTime": {
"currentValue": 2400,
"comparisonValue": 2400,
"absoluteChange": 0,
"percentChange": 0,
"changeDirection": "neutral",
"performance": "neutral",
"isAvailable": true
},
"medianResponseTime": {
"currentValue": 1800,
"comparisonValue": 1800,
"absoluteChange": 0,
"percentChange": 0,
"changeDirection": "neutral",
"performance": "neutral",
"isAvailable": true
},
"averageCsatRating": {
"currentValue": 80,
"comparisonValue": 80,
"absoluteChange": 0,
"percentChange": 0,
"changeDirection": "neutral",
"performance": "neutral",
"isAvailable": true
}
},
"statusBreakdown": [
{
"status": "Resolved by AI",
"count": 70
},
{
"status": "Escalated to Human Agent",
"count": 20
},
{
"status": "Waiting for Customer",
"count": 10
}
],
"usageByChannel": [
{
"channel": "chat",
"count": 100,
"resolved": 70
}
],
"conversationVolumeChartData": [
{
"day": "2026-07-15",
"resolved": 70,
"escalated": 20,
"waitingForCustomer": 10
}
],
"resolutionRateChartData": [
{
"day": "2026-07-15",
"totalConversations": 100,
"resolvedConversations": 70,
"aiResolutionRate": 70
}
],
"responseTimeChartData": [
{
"day": "2026-07-15",
"averageResponseTimeMs": 2400,
"medianResponseTimeMs": 1800
}
],
"knowledgeUsage": {
"current": [
{
"folderId": "4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3",
"total": 100,
"resolved": 70,
"escalated": 20,
"averageCsatPercentage": 80,
"ratedConversations": 10
}
],
"comparison": [
{
"folderId": "4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3",
"total": 100,
"resolved": 70,
"escalated": 20,
"averageCsatPercentage": 80,
"ratedConversations": 10
}
]
},
"ruleAnalytics": [
{
"ruleId": "4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3",
"ruleName": "Order status",
"totalConversations": 100,
"resolvedConversations": 70,
"aiResolutionRate": 70,
"escalatedConversations": 20,
"escalatedRate": 20,
"averageCsatPercentage": 80,
"ratedConversations": 10
}
],
"escalationReasons": [
{
"tagId": "4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3",
"tagName": "Missing Knowledge",
"count": 20
}
],
"hourlyVolume": [
{
"dayOfWeek": 3,
"hour": 12,
"total": 100,
"resolved": 70
}
]
}
Response
Returns an analytics summary object. The example above uses synthetic values; the response is not wrapped inbotId, range, overview, or sections.
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 and median response time, and average CSAT rating. The response-time card keys are
averageResponseTime and medianResponseTime. Each card includes currentValue, comparisonValue, absoluteChange, percentChange, changeDirection, performance, and isAvailable. Response-time values are in milliseconds.array
Conversation counts grouped by status. Status names come from the deployment configuration; example labels are illustrative. Status names come from the deployment configuration; example labels are illustrative.
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 entries with
day, averageResponseTimeMs, and medianResponseTimeMs. Both response-time fields aggregate the stored per-conversation average response times for that day, 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
Arithmetic mean of the stored per-conversation average response times, in milliseconds. Retained alongside the median.
number
Median (50th percentile) of the stored per-conversation average response times, in milliseconds, rounded to the nearest integer. This is not a percentile over individual messages. Returned in both
summary and comparisonSummary; falls back to 0 when no response-time data is available. The corresponding summaryCards.medianResponseTime instead reports currentValue: null and isAvailable: false when unavailable.number
Average CSAT rating.
Errors
400 Bad Request
400 Bad Request
The path ID or query parameters are invalid.
startEpoch and endEpoch are required.401 Unauthorized
401 Unauthorized
The API key is missing, malformed, revoked, or invalid.
403 Forbidden
403 Forbidden
The API key does not include the
read scope required for this route.404 Not Found
404 Not Found
The agent was not found in the authenticated workspace.
406 Not Acceptable
406 Not Acceptable
The authenticated request has no workspace context.
500 Internal Server Error
500 Internal Server Error
Fini failed while loading analytics.
Was this page helpful?