---
title: "Frequent Callers Stats"
method: GET
path: "/campaigns/v1/stats/frequent-callers"
tags: ["Campaign Stats", "Stats"]
---

# Frequent Callers Stats

`GET /campaigns/v1/stats/frequent-callers`

Get phone numbers that placed more than one call within the given date range.

- **start** / **end**: ISO 8601 date range filter applied to conversation start/end time.

Web calls (`callType="web"`) and conversations with no recorded `userNumber` are
excluded. Results are sorted by call count, descending.

## Query parameters

- `size` integer — Number of items per page
- `page` integer — Page number
- `search` string, nullable — Search keywords
- `start` string, date-time, nullable — Filter by start time (ISO 8601 format)
- `end` string, date-time, nullable — Filter by end time (ISO 8601 format)

## Response `200`

Phone numbers that called more than once, grouped by userNumber

- FrequentCallersStatsResponse
  - `message` string, required — Result description
  - `data` FrequentCallerEntry[], required — Phone numbers that called more than once, sorted by call count descending
    - `userNumber` string, required — Caller phone number
    - `count` integer, required — Number of calls placed by this number in the date range

## Other responses

- `400` — Bad request — invalid input or constraint violation
- `404` — Requested resource not found
- `422` — Validation Error
- `500` — Internal server error

## Changes

- **2026-08-27** `a9901c64edf4` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/interactly/apis/interactly-api-2/changes/campaigns/v1/stats/frequent-callers/get.md)

---

[API](https://skmtc.dev/interactly/apis/interactly-api-2.md) · [All operations](https://skmtc.dev/interactly/apis/interactly-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/interactly/interactly-api-2/revisions/a9901c64edf4/schema)