---
title: "Get scoped call analytics interval reports"
method: GET
path: "/v2/calls/metrics/analytics-operations"
tags: ["Calls Metrics"]
---

# Get scoped call analytics interval reports

`GET /v2/calls/metrics/analytics-operations`

## Request

- Base URL: `https://api.carecycle.ai`
- URL: `https://api.carecycle.ai/v2/calls/metrics/analytics-operations`
- Auth: API key in header `x-api-key`

Volume, handled dispositions, busiest intervals and interval/day detail using the same filters and self/organization scope as Call Analytics.

## Query parameters

- `search` string: Search query: matches customer name, phone number, or disposition
- `customerId` string, uuid: Filter calls by customer ID for exact customer call history
- `campaignIds` string: Optional array of campaign IDs to filter calls by specific campaigns (comma-separated string)
- `agentUserIds` string: Optional array of agent user IDs to filter calls by specific softphone agents (comma-separated string)
- `durationOperator` '<=' | '>=': Duration filter operator (less than or equal, greater than or equal)
- `durationValue` number: Duration value in seconds to filter by
- `direction` 'inbound' | 'outbound': Filter by call direction
- `callType` 'voice_ai' | 'softphone': Filter by call type: Voice AI or Softphone
- `startDate` string, date-time: Start date-time for call range filtering. ISO 8601 timestamp
- `endDate` string, date-time: End date-time for call range filtering. ISO 8601 timestamp
- `excludeDispositions` string: Array of disposition names to exclude from results (comma-separated string)
- `includeDispositions` string: Array of disposition names to limit results to (comma-separated string). Combines with excludeDispositions when both are sent.
- `excludeSources` string: Array of source ids to exclude from results (comma-separated string)
- `includeTestCalls` 'true' | 'false': When true, test calls are included in results. Default behavior is to exclude test calls.
- `connectedCallsOnly` 'true' | 'false': Filter for connected calls only using disposition outcome types, with a legacy name fallback. Default behavior is to include all calls.
- `includeErrorDispositions` 'true' | 'false': Deprecated compatibility parameter. Error dispositions are always excluded, regardless of this value.
- `intervalMinutes` number

## Response `200`

GET /v2/calls/metrics/analytics-operations Positive response

- GetV2CallsMetricsAnalyticsOperationsPositiveResponse
  - `timezone` string, required
  - `asOf` string, date-time, required
  - `startDate` string, date, required
  - `endDate` string, date, required
  - `direction` 'all' | 'inbound' | 'outbound', required
  - `handler` 'all' | 'softphone' | 'voice_ai', required
  - `intervalMinutes` union, required
    - 30
    - 60
  - `slaThresholdSeconds` number, required
  - `summary` object, required
    - `totalCalls` number, required
    - `inbound` number, required
    - `outbound` number, required
    - `offered` number, required
    - `answered` number, required
    - `abandoned` number, required
    - `preQueueAbandoned` number, required
    - `preQueueUnknown` number, required
    - `otherInbound` number, required
    - `aiInbound` number, required
    - `aiOtherInbound` number, required
    - `aiToAgent` number, required
    - `aiHandoffs` number, required
    - `aiHandoffsAnswered` number, required
    - `answeredWithinSla` number, required
    - `answerWaitSamples` number, required
    - `totalAnswerWaitMs` number, required
    - `handled` number, required
    - `talkSamples` number, required
    - `totalTalkMs` number, required
    - `handleSamples` number, required
    - `totalHandleMs` number, required
    - `dncDetected` number, required
    - `callbackAccepted` number, required
    - `timedOut` number, required
    - `fallback` number, required
    - `unavailableMessage` number, required
    - `fallbackTransfer` number, required
    - `technicalFailure` number, required
    - `waiting` number, required
    - `unknown` number, required
    - `transferred` number, required
    - `multiAgent` number, required
    - `noHoldRecorded` number, required
    - `holdRecorded` number, required
    - `holdTimingIncomplete` number, required
    - `legacyTiming` number, required: Deprecated: known incomplete hold timing on handled human calls; absence of hold evidence is treated as zero hold time.
    - `notConnected` number, required
    - `notConnectedRate` number, nullable, required
    - `answerRate` number, nullable, required
    - `abandonRate` number, nullable, required
    - `serviceLevel` number, nullable, required
    - `averageSpeedOfAnswerMs` number, nullable, required
    - `averageTalkMs` number, nullable, required
    - `averageHandleMs` number, nullable, required
  - `intervals` object[], required
    - `totalCalls` number, required
    - `inbound` number, required
    - `outbound` number, required
    - `offered` number, required
    - `answered` number, required
    - `abandoned` number, required
    - `preQueueAbandoned` number, required
    - `preQueueUnknown` number, required
    - `otherInbound` number, required
    - `aiInbound` number, required
    - `aiOtherInbound` number, required
    - `aiToAgent` number, required
    - `aiHandoffs` number, required
    - `aiHandoffsAnswered` number, required
    - `answeredWithinSla` number, required
    - `answerWaitSamples` number, required
    - `totalAnswerWaitMs` number, required
    - `handled` number, required
    - `talkSamples` number, required
    - `totalTalkMs` number, required
    - `handleSamples` number, required
    - `totalHandleMs` number, required
    - `dncDetected` number, required
    - `callbackAccepted` number, required
    - `timedOut` number, required
    - `fallback` number, required
    - `unavailableMessage` number, required
    - `fallbackTransfer` number, required
    - `technicalFailure` number, required
    - `waiting` number, required
    - `unknown` number, required
    - `transferred` number, required
    - `multiAgent` number, required
    - `noHoldRecorded` number, required
    - `holdRecorded` number, required
    - `holdTimingIncomplete` number, required
    - `legacyTiming` number, required: Deprecated: known incomplete hold timing on handled human calls; absence of hold evidence is treated as zero hold time.
    - `notConnected` number, required
    - `notConnectedRate` number, nullable, required
    - `answerRate` number, nullable, required
    - `abandonRate` number, nullable, required
    - `serviceLevel` number, nullable, required
    - `averageSpeedOfAnswerMs` number, nullable, required
    - `averageTalkMs` number, nullable, required
    - `averageHandleMs` number, nullable, required
    - `key` string, required
    - `label` string, required
    - `startMinute` number, nullable, required
    - `state` 'complete' | 'in_progress' | 'upcoming', required
  - `days` object[], required
    - `totalCalls` number, required
    - `inbound` number, required
    - `outbound` number, required
    - `offered` number, required
    - `answered` number, required
    - `abandoned` number, required
    - `preQueueAbandoned` number, required
    - `preQueueUnknown` number, required
    - `otherInbound` number, required
    - `aiInbound` number, required
    - `aiOtherInbound` number, required
    - `aiToAgent` number, required
    - `aiHandoffs` number, required
    - `aiHandoffsAnswered` number, required
    - `answeredWithinSla` number, required
    - `answerWaitSamples` number, required
    - `totalAnswerWaitMs` number, required
    - `handled` number, required
    - `talkSamples` number, required
    - `totalTalkMs` number, required
    - `handleSamples` number, required
    - `totalHandleMs` number, required
    - `dncDetected` number, required
    - `callbackAccepted` number, required
    - `timedOut` number, required
    - `fallback` number, required
    - `unavailableMessage` number, required
    - `fallbackTransfer` number, required
    - `technicalFailure` number, required
    - `waiting` number, required
    - `unknown` number, required
    - `transferred` number, required
    - `multiAgent` number, required
    - `noHoldRecorded` number, required
    - `holdRecorded` number, required
    - `holdTimingIncomplete` number, required
    - `legacyTiming` number, required: Deprecated: known incomplete hold timing on handled human calls; absence of hold evidence is treated as zero hold time.
    - `notConnected` number, required
    - `notConnectedRate` number, nullable, required
    - `answerRate` number, nullable, required
    - `abandonRate` number, nullable, required
    - `serviceLevel` number, nullable, required
    - `averageSpeedOfAnswerMs` number, nullable, required
    - `averageTalkMs` number, nullable, required
    - `averageHandleMs` number, nullable, required
    - `key` string, required
    - `label` string, required
    - `startMinute` number, nullable, required
    - `state` 'complete' | 'in_progress' | 'upcoming', required
  - `emptyDaysOmitted` boolean
  - `busiest` object[], required
    - `totalCalls` number, required
    - `inbound` number, required
    - `outbound` number, required
    - `offered` number, required
    - `answered` number, required
    - `abandoned` number, required
    - `preQueueAbandoned` number, required
    - `preQueueUnknown` number, required
    - `otherInbound` number, required
    - `aiInbound` number, required
    - `aiOtherInbound` number, required
    - `aiToAgent` number, required
    - `aiHandoffs` number, required
    - `aiHandoffsAnswered` number, required
    - `answeredWithinSla` number, required
    - `answerWaitSamples` number, required
    - `totalAnswerWaitMs` number, required
    - `handled` number, required
    - `talkSamples` number, required
    - `totalTalkMs` number, required
    - `handleSamples` number, required
    - `totalHandleMs` number, required
    - `dncDetected` number, required
    - `callbackAccepted` number, required
    - `timedOut` number, required
    - `fallback` number, required
    - `unavailableMessage` number, required
    - `fallbackTransfer` number, required
    - `technicalFailure` number, required
    - `waiting` number, required
    - `unknown` number, required
    - `transferred` number, required
    - `multiAgent` number, required
    - `noHoldRecorded` number, required
    - `holdRecorded` number, required
    - `holdTimingIncomplete` number, required
    - `legacyTiming` number, required: Deprecated: known incomplete hold timing on handled human calls; absence of hold evidence is treated as zero hold time.
    - `notConnected` number, required
    - `notConnectedRate` number, nullable, required
    - `answerRate` number, nullable, required
    - `abandonRate` number, nullable, required
    - `serviceLevel` number, nullable, required
    - `averageSpeedOfAnswerMs` number, nullable, required
    - `averageTalkMs` number, nullable, required
    - `averageHandleMs` number, nullable, required
    - `key` string, required
    - `label` string, required
    - `startMinute` number, nullable, required
    - `state` 'complete' | 'in_progress' | 'upcoming', required
  - `dispositions` object[], required
    - `disposition` string, required
    - `count` number, required
    - `share` number, required
  - `durationCoverage` object[], required
    - `kind` string, required
    - `direction` string, required
    - `calls` number, required
    - `handled` number, required
    - `talkSamples` number, required
    - `handleSamples` number, required
  - `availableFilters` object, required
    - `campaigns` object[], required
      - `id` string, required
      - `name` string, required
    - `destinations` object[], required
      - `id` string, required
      - `name` string, required

## Other responses

- `400`: GET /v2/calls/metrics/analytics-operations Negative response 400
- `401`: GET /v2/calls/metrics/analytics-operations Negative response 401
- `403`: GET /v2/calls/metrics/analytics-operations Negative response 403
- `404`: GET /v2/calls/metrics/analytics-operations Negative response 404
- `409`: GET /v2/calls/metrics/analytics-operations Negative response 409
- `422`: GET /v2/calls/metrics/analytics-operations Negative response 422
- `429`: GET /v2/calls/metrics/analytics-operations Negative response 429
- `500`: GET /v2/calls/metrics/analytics-operations Negative response 500
- `502`: GET /v2/calls/metrics/analytics-operations Negative response 502
- `503`: GET /v2/calls/metrics/analytics-operations Negative response 503

---

[API](https://skmtc.dev/carecycle/apis/carecycle-public-api.md) - [All operations](https://skmtc.dev/carecycle/apis/carecycle-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/carecycle/apis/carecycle-public-api/revisions/db390c743c36?raw)