---
title: "List call transcriptions"
method: GET
path: "/transcriptions"
tags: ["transcriptions"]
---

# List call transcriptions

`GET /transcriptions`

Retrieves your team's call transcriptions with optional filters (date range, duration, pagination).

**Permission:** This endpoint is not governed by API token permissions. Your team must have the **transcription feature enabled** in its plan.

**Monitoring:** No impact.

For each transcription, in the items of the array of the <em>transcription_data.speeches</em> field, the field <em>channelId</em> takes one of the following values:
- <em>1</em> for the caller emitting the call
- <em>0</em> for the callee receiving the call

If the call is received by a Ringover user while the call is emitted by a call member that is not a registered contact, the <em>contact</em> field will be <em>null</em>.

The maximum rows returned has to be set in the parameter <em>limit_count</em> (limited to 100 rows). All the parameters are optional. The full text of each transcription is fetched per row, so larger pages would time out: paginate through your transcriptions with `limit_offset` in pages of up to 100. A `limit_count` above 100 is rejected with a `422`.

**Search mode:** When the `search` query parameter is provided, a semantic vector search is run on transcription content. In this mode the filters `audio_duration_from`, `audio_duration_to`, `created_from`, `created_to` and `limit_offset` are **ignored**, and only `limit_count` is honored (it caps the number of matches returned, up to 100).

## Query parameters

- `limit_count` integer
- `limit_offset` integer
- `search` string
- `audio_duration_from` integer
- `audio_duration_to` integer
- `created_from` string, date-time
- `created_to` string, date-time

## Response `200`

Successful operation — returns the list of transcriptions matching your filters.

- TranscriptionsObject[]
  - `id` integer
  - `team_id` integer
  - `user_id` integer
  - `standard_id` integer, nullable
  - `cdr_id` integer
  - `call_id` string
  - `channel_id` string
  - `provider` string
  - `user` UserLight
    - `user_id` integer — The user identifier
    - `team_id` integer — The team identifier of the user
    - `initial` string — The initials of the user
    - `color` string
    - `firstname` string — The firstname of the user
    - `lastname` string — The lastname of the user
    - `company` string — The company of the user
    - `email` string — The email of the user
    - `picture` string — The picture of the user
    - `concat_name` string
  - `contact` Contact
    - `contact_id` integer
    - `is_shared` boolean
    - `im_owner` string
    - `social_service` string, nullable
    - `social_service_id` string
    - `social_profile_url` string, nullable
    - `social_data` string, nullable
    - `firstname` string
    - `lastname` string
    - `company` string
    - `concat_name` string
    - `color` string
    - `initial` string
    - `profile_picture` string, nullable
    - `creation_date` string, date-time
    - `numbers` integer[], nullable
  - `transcription_data` object
    - `duration` string
    - `num_channels` integer
    - `speeches` object[]
      - `channelId` integer — The identifier for the call members: the caller has the Channel ID <em>1</em>, and the callee has the Channel ID <em>0</em>.
      - `start` number
      - `end` number
      - `duration` number
      - `text` string
      - `words` object[]
        - `text` string
        - `start` number
        - `end` number
      - `named_entities` object[]
        - `label` string
        - `text` string
        - `score` number
        - `start` integer
        - `end` integer
    - `text` string
    - `prediction_time` number
  - `transcription_status` string
  - `creation_date` string, date-time

## Other responses

- `204` — No content — no transcriptions match the given filters.
- `400` — Bad request — invalid query parameter value.
- `401` — Unauthorized — missing or invalid token, or transcription feature not enabled for your team.
- `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)