---
title: "List analyzed calls"
method: GET
path: "/empower/calls"
tags: ["empower"]
---

# List analyzed calls

`GET /empower/calls`

Retrieves a list of calls analyzed by Empower, with optional filters (date range, direction, language, mood, etc.).

**Permission:** `Empower Read` required.

**Monitoring:** No impact. Visibility depends on your Empower role: Admin sees all team calls, Supervisor sees supervised users' calls, User sees own calls only.

**Date and creation date constraints:**
- `call_date_from` must be before or equal to `call_date_to`.
- The range between `call_date_from` and `call_date_to` must be **15 days or less**.
- `creation_date_from` must be before or equal to `creation_date_to`.
- The range between `creation_date_from` and `creation_date_to` must be **15 days or less**.

## Query parameters

- `call_source` string
- `call_direction` 'in' | 'out'
- `call_date_from` string
- `call_date_to` string
- `creation_date_from` string
- `creation_date_to` string
- `audio_duration_from` number
- `audio_duration_to` number
- `language` string
- `favorite` boolean
- `state` 'pending' | 'done' | 'error' | 'planified' | 'invalid'
- `moment_id` string
- `user_id` string
- `phone_number` string
- `speaker_type` 'client' | 'agent'
- `mood_label` 'positive' | 'negative' | 'neutral'
- `tags` string
- `sort_order` 'DESC' | 'ASC'
- `offset` integer
- `limit` integer
- `search_text` string

## Response `200`

Successful operation — returns the list of matching analyzed calls.

- GetCallEmpowerResBody[]
  - `call_uuid` string, uuid
  - `call_id` string
  - `channel_id` string
  - `external_id` string
  - `audio_url` string — CDN URL of the call recording. This URL cannot be opened with a public API token. Download the file with `POST /cdn/download`.
  - `video_url` string — CDN URL of the call video, when present. This URL cannot be opened with a public API token. Download the file with `POST /cdn/download`.
  - `audio_duration` number, double
  - `call_direction` string
  - `call_source` string
  - `favorite` boolean
  - `title` string
  - `call_date` string, date-time
  - `creation_date` string, date-time
  - `language` string
  - `state` string
  - `moments` Moment[]
    - `moment_id` integer
    - `team_id` integer
    - `label` string
    - `color` string
    - `emoji` string
    - `keywords` Keyword[]
      - `keyword_id` integer
      - `label` string
      - `language` string
      - `segment_id` integer
      - `created_by` integer
      - `creation_date` string, date-time
    - `group_ids` integer[]
    - `created_by` integer
    - `updated_by` integer
    - `creation_date` string, date-time
    - `update_date` string, date-time
  - `speakers` Speaker[]
    - `phone_number` number
    - `channel_index` number
    - `user_id` number
    - `mood_score` number, double
    - `speech_time` number, double
    - `words_rate` number, double
    - `longest_monologue` number, double
    - `number_of_pauses_within_speech` number
    - `average_duration_of_pauses_within_speech` number, double
    - `number_of_pauses_between_speakers` number
    - `average_duration_of_pauses_between_speakers` number, double
    - `number_of_interruptions` number
    - `number_of_questions` number
    - `creation_date` string, date-time
    - `update_date` string, date-time
    - `interruptions` object
      - `segment_id` number
    - `speaker_type` 'client' | 'agent'
    - `mood_label` string
  - `tags_ids` integer[]
  - `transcription_url` string — CDN URL of the transcription JSON. This URL cannot be opened with a public API token. Download the file with `POST /cdn/download`.
  - `summary_url` string — Deprecated: URL of the legacy extractive summary file. This pipeline is no longer running, so this field is generally `null`. Use `recap_url` instead.
  - `waveform_url` string
  - `recap_url` string — CDN URL of the recap file holding the AI analysis of the call, including the summary per language. This is the source of the summary displayed in Empower. This URL cannot be opened with a public API token. Download the file with `POST /cdn/download`.
  - `manager_rating` 1 | 2 | 3 | 4 | 5
  - `platform_name` string
  - `duration` integer
  - `num_channels` integer
  - `dead_air` integer
  - `notes` Note[]
    - `note_id` integer
    - `user_id` integer
    - `message` string
    - `creation_date` string, date-time
    - `update_date` string, date-time
  - `visited` integer
  - `last_visited` string, date-time

## Other responses

- `400` — Bad request — invalid parameters or validation failed (e.g. date range > 15 days, start date after end date).
- `401` — Unauthorized — missing or invalid token, or insufficient Empower Read permission.
- `500` — Internal server error.

## Changes

- **2026-08-25** `241a8d30fa9b` — 1 info
  - response property `items/summary_url` deprecated

[Change history](https://skmtc.dev/ringover/apis/ringover-public-api/changes/empower/calls/get.md)

---

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