---
title: "Get Empower call logs"
method: POST
path: "/empower/logs/calls"
tags: ["empower"]
---

# Get Empower call logs

`POST /empower/logs/calls`

Returns a list of Empower call records (CDR list).

## Request body

- EmpowerLogsCallsRequest — Request body for Empower logs/calls. All fields are optional; omit or send empty to use defaults.
  - `start_date` string, date-time — Start date for the filter range (inclusive).
  - `end_date` string, date-time — End date for the filter range (inclusive).
  - `tags` integer[] — Empower tag IDs to filter by.
  - `related_to` integer[] — Related-to IDs to filter by.
  - `related_meet` string — Related meet identifier to filter by.
  - `folder_uuid` string, uuid — Folder UUID to filter calls.
  - `number` integer — Single phone number to filter by.
  - `numbers` integer[] — Phone numbers to filter by.
  - `transcription_state` string — Transcription state filter (e.g. PENDING, DONE, ERROR).
  - `call_sources` string[] — Call source values to filter by.
  - `speaker_types` string[] — Speaker types (e.g. client, agent).
  - `agent_mood_labels` string[] — Agent mood labels to filter by.
  - `mood_labels` string[] — Client mood labels to filter by.
  - `favorite` boolean — Filter by favorite flag.
  - `query_phrase` string — Full-text search phrase in transcription.
  - `call_name` string — Call name filter (LIKE pattern supported).
  - `flags` string[] — Flag IDs to filter by.
  - `moments` integer[] — Moment IDs to filter by.
  - `call_category_uuid` string, uuid — Call category UUID to filter by.
  - `call_category_uuid_string` string — Call category UUID as string.
  - `languages` string[] — Language codes to filter by.
  - `cai_providers` string[] — CAI provider names to filter by.
  - `groups` integer[] — Group IDs to filter by.
  - `users` integer[] — User IDs to filter by.
  - `lower_call_rating` integer — Minimum call rating (inclusive).
  - `upper_call_rating` integer — Maximum call rating (inclusive).
  - `lower_sales_framework_score` integer — Minimum sales framework score (inclusive).
  - `upper_sales_framework_score` integer — Maximum sales framework score (inclusive).
  - `framework_uuid` string[] — Framework UUIDs to filter by.
  - `lower_audio_duration` integer — Minimum audio duration in seconds (inclusive).
  - `upper_audio_duration` integer — Maximum audio duration in seconds (inclusive).
  - `limit_count` integer — Max number of records to return.
  - `limit_offset` integer — Pagination offset (number of records to skip).
  - `call_uuids` string[] — Specific call UUIDs to fetch.
  - `is_persona` boolean — Filter by persona flag.
  - `contexts` string[] — Call context/direction (e.g. in, out).

## Response `200`

Successful operation – list of call records (CDR list)

- EmpowerLogsCallsResponse — Empower call logs list (CDR list).
  - `total_calls` integer — Total number of calls matching the filters.
  - `total_pages` integer — Total number of pages for pagination.
  - `limit_offset_setted` integer — Pagination offset that was applied.
  - `limit_count_setted` integer — Page size (limit) that was applied.
  - `cdr_list_count` integer — Number of call records in this response.
  - `cdr_list` object[] — List of call records (CDRs).
    - `call_uuid` string, uuid — Unique identifier of the call.
    - `external_id` string — External identifier (e.g. from meeting provider).
    - `provider` string, nullable — CAI/provider name.
    - `call_date` string, date-time — Date and time of the call.
    - `audio_duration` number — Duration of the audio in seconds.
    - `context` string, nullable — Call context or direction.
    - `call_source` string — Source of the call (e.g. video, phone).
    - `is_favorite` boolean — Whether the call is marked as favorite.
    - `language` string — Language code of the call.
    - `transcription_state` string — State of transcription (e.g. PENDING, DONE, ERROR).
    - `moments` integer[] — List of moment IDs.
    - `call_category_uuid` string, uuid — UUID of the call category.
    - `speakers` object[] — List of speakers in the call.
      - `phone_number` integer
      - `user_id` string — User identifier.
      - `nickname` string — Display name of the speaker.
      - `speaker_type` string — Type of speaker (e.g. AGENT, CLIENT).
      - `mood_label` string — Mood label (e.g. NEUTRAL).
      - `CallUUIstr` string — Call UUID string for the speaker.
    - `tags` integer[], nullable — Tag IDs associated with the call.
    - `recap_url` string — URL to the after-call recap JSON.
    - `sales_analysis_url` string — URL to the sales analysis JSON.
    - `transcription_url` string — URL to the transcript JSON.
    - `call_rating` integer — Call rating score.
    - `sales_framework_score` number — Sales framework score.
    - `framework_uuid` string, uuid, nullable — UUID of the sales framework.
    - `updated_by` integer — User ID of who last updated the call.
    - `update_date` string, date-time — Last update date and time.
    - `platform_name` string, nullable — Name of the meeting/call platform.
    - `moment_keywords` object[] — Moment IDs with keyword counts.
      - `moment_id` integer
      - `keyword_count` integer
    - `call_url` string — URL to the call recording (e.g. MP3).
    - `meet_url` string — URL of the meeting (e.g. Google Meet link).
    - `meeting_name` string — Name of the meeting.
    - `call_name` string — Name of the call.
    - `is_private` integer — Whether the call is private (0 or 1).
    - `flags` integer[], nullable — Flag IDs.
    - `persona_uuid` string, nullable — UUID of the persona if set.
    - `metadata` string — Additional metadata.

## Other responses

- `204` — No content – no calls match the filters
- `400` — Bad request – invalid request body
- `401` — Token unauthorized
- `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)