---
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
  - `video_url` string
  - `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
  - `summary_url` string
  - `waveform_url` string
  - `recap_url` string
  - `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.

---

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