---
title: "Get Calls Count"
method: GET
path: "/v2/calls/count"
tags: ["Calls"]
---

# Get Calls Count

`GET /v2/calls/count`

## Request

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

Get the total count of calls matching filters. Separated from the main calls endpoint for faster initial page loads.

## 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.

## Response `200`

GET /v2/calls/count Positive response

- GetV2CallsCountPositiveResponse
  - `count` number, required: Total number of calls matching the filters

## Other responses

- `400`: GET /v2/calls/count Negative response 400
- `401`: GET /v2/calls/count Negative response 401
- `403`: GET /v2/calls/count Negative response 403
- `404`: GET /v2/calls/count Negative response 404
- `409`: GET /v2/calls/count Negative response 409
- `422`: GET /v2/calls/count Negative response 422
- `429`: GET /v2/calls/count Negative response 429
- `500`: GET /v2/calls/count Negative response 500
- `502`: GET /v2/calls/count Negative response 502
- `503`: GET /v2/calls/count 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)