---
title: "Retrieve call summaries by date range or user"
method: POST
path: "/empower/call"
tags: ["empower"]
---

# Retrieve call summaries by date range or user

`POST /empower/call`

Retrieves call summaries for a specified user within a given date range, including recap, moments, transcription, and scores.

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

## Request body

- object
  - `start_date` string, date-time, required — The start date for filtering calls (optional).
  - `end_date` string, date-time, required — The end date for filtering calls (optional).
  - `user_id` integer, required — The ID of the user for whom the summary is requested (optional).
  - `limit` integer, required — Limit the number of calls returned. Defaults to 10 if not provided (max 10).
  - `offset` integer, required — Offset for pagination. Use this to skip a number of calls.

## Response `200`

A list of call summaries.

- object[]
  - `recap` object
    - `summary` object
      - `french` string — Recap summary in French.
      - `english` string, nullable — Recap summary in English.
      - `spanish` string, nullable — Recap summary in spanish.
    - `type` string — Type of call.
    - `important` boolean — Indicates if the call is marked as important.
    - `importance_score` integer — Importance score of the call.
    - `review_reasons` string[] — Reasons for review.
    - `customer_satisfaction_score` integer, nullable
    - `information_accuracy` string, nullable
    - `politeness_professionalism` boolean
    - `call_reasons` string[]
    - `pain_points` string[]
    - `follow_up_actions` string[]
    - `resolution_steps` string[]
    - `call_outcome` string — Outcome of the call.
    - `customer_sentiment` string — Sentiment of the customer.
    - `sales_opportunities` string[]
    - `call_rating` integer — Rating of the call.
  - `call_score` integer — Score of the call.
  - `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
  - `transcription` object
    - `duration` number, float — Duration of the transcription.
    - `num_channels` integer, nullable
    - `speeches` object[]
      - `channelId` integer
      - `start` number, float
      - `end` number, float
      - `duration` number, float
      - `text` string
      - `words` object[]
        - `text` string
        - `start` number, float
        - `end` number, float
    - `text` string, nullable
    - `prediction_time` number, float — Prediction time.

## Other responses

- `204` — No content — no calls found for the given filters.
- `400` — Bad request — validation error (e.g. `start_date` after `end_date`, or `limit` exceeds 10).
- `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)