Get Daily Call Metrics
Retrieve per-day call history metrics for the workspace.
Returns call history aggregates as a per-day series. Aggregate totals for the same window are on Get Call History Metrics.
Headers
x-workspace-idstringrequiredWorkspace identifier for the API.
Query Parameters
dateRangestringrequiredJSON string with startDate and endDate ISO 8601 timestamps, applied to the call start time. Example: {"startDate":"2026-10-01T00:00:00Z","endDate":"2026-10-31T23:59:59Z"}.
timezonestringIANA timezone used to group calls into days and to evaluate windows. Defaults to UTC.
windowsstringOptional JSON object of business-hours windows keyed by day, e.g. {"2026-10-01":{"start":"09:00","end":"17:00"}}. Times are HH:MM in timezone; start is inclusive and end exclusive. Days that are missing, null or have an invalid window count as closed. At most 400 days.
agentIdstringFilter by agent ID, or by agent name.
statusstringFilter by call status: completed, pending, failed or blocked.
directionstringFilter by call direction: inbound, outbound or web.
pathwayIdstringFilter by call flow ID.
batchIdstringFilter by batch call ID.
callIdsstringJSON-stringified array of call IDs.
callTypestringFilter by call type: sip or web.
searchstringFree-text search, same as on List Call Histories. At most 200 characters.
postAnalysisstringJSON-stringified array of post-call analysis filter objects, same as on List Call Histories.
Response Fields
timezonestringThe timezone the days were computed in.
daysarrayOne entry per day that has at least one call, sorted by date. Days with no calls are omitted.
Errors
| Status | Body | When |
|---|---|---|
400 | {"error": "dateRange is required"} | dateRange is missing |
400 | {"error": "dateRange must be a JSON object with startDate and endDate ..."} | dateRange is invalid |
{
"timezone": "America/New_York",
"days": [
{
"day": "2026-10-01",
"total": 12,
"completed": 11,
"inHours": 9,
"inHoursCompleted": 9,
"durationSum": 1534
}
]
}Last updated on