---
title: "Get Voice Log"
method: GET
path: "/api/v1/logs/voice/{external_id}"
tags: ["logs"]
---

# Get Voice Log

`GET /api/v1/logs/voice/{external_id}`

## Path parameters

- `external_id` string, required

## Query parameters

- `include_staging` boolean — Include staging calls. Used by the cockpit clone logs.

## Response `200`

Successful Response

- Call — Represents a voice call for API responses.
  - `id` string, uuid, required
  - `external_id` string, required
  - `root_call_id` string, uuid, nullable
  - `external_assistant_id` string, nullable, required
  - `type` 'inboundPhoneCall' | 'outboundPhoneCall' | 'webCall', required
  - `messages` object[], required
  - `transcript` string, required
  - `summary` string, nullable, required
  - `structured_data` object, nullable, required
  - `created_at` string, date-time, required
  - `status` string, required
  - `metadata` union, required
    - DeprecatedFollowUpCallMetadata — Legacy follow-up call metadata (for backwards compatibility).
      - `type` 'deprecated_follow_up'
      - `is_follow_up` boolean, required
      - `original_call_id` string, nullable
    - OutboundCallMetadata — Metadata for outbound calls initiated via run items.
      - `type` 'outbound'
      - `voice_agent_outbound_run_item_ids` string[], required
  - `customer_number` string, nullable, required
  - `recording_url` string, nullable, required
  - `recording_presigned_url` string, nullable
  - `duration_seconds` integer, nullable
  - `ended_reason` string, nullable, required
  - `voice_agent_names` object
  - `voice_agent_id` string, uuid, nullable
  - `voice_agent_group_name` string, nullable
  - `had_warm_transfer` boolean
  - `booking_made` boolean, nullable
  - `attributed_to_human_agent_id` string, uuid, nullable
  - `booking_value_cents` integer, nullable
  - `booking_outcome_set_by_user_id` string, uuid, nullable
  - `booking_outcome_set_at` string, date-time, nullable
  - `booking_status` string, nullable
  - `booking_evidence` string, nullable
  - `outcome_agent_ref` string, nullable
  - `customer_profile_id` string, uuid, nullable
  - `customer_name` string, nullable
  - `participant_recordings` ParticipantRecording[], nullable
    - `identity` string, nullable
    - `role` string, nullable
    - `recording_presigned_url` string, required

## Other responses

- `403` — Missing the required permission for call logs
- `404` — Voice call not found
- `422` — Validation Error

---

[API](https://skmtc.dev/getanana/apis/cleon-api.md) · [All operations](https://skmtc.dev/getanana/apis/cleon-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getanana/cleon-api/revisions/c0f54348e251/schema)