---
title: "Get Unified Transcript"
method: GET
path: "/api/v1/voice-calls/{voice_call_id}/unified-transcript"
tags: ["unified-transcript"]
---

# Get Unified Transcript

`GET /api/v1/voice-calls/{voice_call_id}/unified-transcript`

Return the assembled transcript + transfer events as one ordered timeline.

## Path parameters

- `voice_call_id` string, uuid, required

## Response `200`

Successful Response

- UnifiedTranscriptResponse — Response payload for GET /voice-calls/{id}/unified-transcript.
  - `voice_call_id` string, uuid, required
  - `items` union[], required
    - union
      - UnifiedTranscriptSegmentItem — A transcript segment item in the unified timeline.
        - `type` 'segment'
        - `timestamp_ms` integer, required
        - `speaker_type` 'ai_agent' | 'customer' | 'human_agent' | 'unknown_human', required
        - `speaker_label` string, required
        - `voice_agent_id` string, uuid, nullable
        - `human_agent_id` string, uuid, nullable
        - `message_id` string, uuid, nullable
        - `text` string, required
        - `source` 'talking_agent_stt' | 'listener_agent_stt' | 'post_call_stt' | 'manual', required
      - UnifiedTranscriptTransferItem — A transfer event item in the unified timeline.
        - `type` 'transfer_event'
        - `timestamp_ms` integer, required
        - `transfer_mode` 'warm' | 'cold' | 'voice_agent_transfer', required
        - `from_label` string, required
        - `to_label` string, required
        - `status` 'initiated' | 'completed' | 'failed', required
        - `failure_reason` string, nullable
  - `transcript_status` 'complete' | 'incomplete' | 'not_applicable', required

## Other responses

- `404` — Voice call not found
- `422` — Validation Error

## Changes

> 19 revisions in range; 1 not diffed.

- **2026-09-03** `d65b8fefae34` — 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status

[Change history](https://skmtc.dev/getanana/apis/cleon-api/changes/api/v1/voice-calls/:voice_call_id/unified-transcript/get.md)

---

[API](https://skmtc.dev/getanana/apis/cleon-api.md) · [All operations](https://skmtc.dev/getanana/apis/cleon-api/llms.txt) · [OpenAPI document](https://skmtc.dev/getanana/apis/cleon-api/revisions/34f2d9e81b0b?raw)