Get calls duration distribution
Histogram of call durations bucketed into <30s, 30-60s, 1-3m, 3-5m, 5m+.
Request
- Base URLhttps://api.carecycle.ai
- URLhttps://api.carecycle.ai/v2/calls/metrics/duration-buckets
- AuthAPI key in header x-api-key
Query parameters
Search query: matches customer name, phone number, or disposition
Filter calls by customer ID for exact customer call history
Optional array of campaign IDs to filter calls by specific campaigns (comma-separated string)
Optional array of agent user IDs to filter calls by specific softphone agents (comma-separated string)
Duration filter operator (less than or equal, greater than or equal)
Duration value in seconds to filter by
Filter by call direction
Filter by call type: Voice AI or Softphone
Start date-time for call range filtering. ISO 8601 timestamp
End date-time for call range filtering. ISO 8601 timestamp
Array of disposition names to exclude from results (comma-separated string)
Array of disposition names to limit results to (comma-separated string). Combines with excludeDispositions when both are sent.
Array of source ids to exclude from results (comma-separated string)
When true, test calls are included in results. Default behavior is to exclude test calls.
Filter for connected calls only using disposition outcome types, with a legacy name fallback. Default behavior is to include all calls.
Deprecated compatibility parameter. Error dispositions are always excluded, regardless of this value.
GET /v2/calls/metrics/duration-buckets Parameter
GET /v2/calls/metrics/duration-buckets Parameter
Response
GET /v2/calls/metrics/duration-buckets Positive response
Changes
No recorded changes to this operation across all 2 revisions of this API.