---
title: "Get voice call details"
method: GET
path: "/voice/logs/{message_id}"
tags: ["voice"]
---

# Get voice call details

`GET /voice/logs/{message_id}`

## Request

- Base URL: `https://cpaas.zoho.com/v1.1`
- URL: `https://cpaas.zoho.com/v1.1/voice/logs/{message_id}`
- Auth: API key in header `Authorization`

Returns the complete details of a single voice call, including the timeline, the rendered IVR flow (nodes, prompts, keypad edges) and, when applicable, the template used for a specific message id.

## Response `200`

Voice call details retrieved successfully.

- VoiceCallDetailResponse: Response containing the details of a single voice call.
  - `data` VoiceCallDetail: A voice call log entry.
    - `message_id` string, uuid: Unique identifier of the call.
    - `request_id` string: Identifier of the send request.
    - `client_reference` string: Client reference supplied at send time, if any.
    - `template_key` string, uuid: Key of the voice template used, for template calls.
    - `agent_id` string: Identifier of the voice agent.
    - `from` string: Caller number, without the country code.
    - `from_country_code` string: Country calling code of the caller number.
    - `to` string: Recipient number, without the country code.
    - `to_country_code` string: Country calling code of the recipient number.
    - `status` 'INITIATED' | 'ANSWERED' | 'CALL_REJECTED' | 'CALL_UNANSWERED' | 'CALL_FAILED' | 'PROCESS_FAILED' | 'UNKNOWN': Call status.
    - `process_state` string: Processing state of the request.
    - `remote_ip` string: IP address the send request was made from.
    - `language` string: Text-to-speech language of the call.
    - `voice_gender` string: Text-to-speech voice of the call.
    - `is_batch_request` boolean
    - `is_call_recording_available` boolean: Whether a recording of the call is available.
    - `request_time` string: When the send request was received (ISO 8601).
    - `start_time` string: When the call started (ISO 8601).
    - `answered_time` string: When the call was answered (ISO 8601). Present only for answered calls.
    - `end_time` string: When the call ended (ISO 8601).
    - `time_taken` integer: Duration in seconds.
    - `template_name` string: Name of the voice template used, for template calls.
    - `call_timeline` object[]: Chronological call events. For calls that failed initiation (status `PROCESS_FAILED`) only `request_received` is present.
      - `time` string
      - `event` string
    - `flow` VoiceCallFlow: The IVR flow executed for the call: named nodes with spoken/paused prompts (and optional keypad `gather` settings), edges that map keypad input to the next node, the start node and the overall duration limit.
      - `max_duration_in_sec` integer: Maximum call duration in seconds.
      - `start_node` string: Name of the node the call starts at.
      - `default_language` string: Default text-to-speech language of the flow.
      - `nodes` object: Flow nodes keyed by node name. Each node has display `name`, `terminal` flag, `prompts` (SPEAK text / PAUSE duration) and optional `gather` settings (`num_digits`, `timeout`, `loops`) for keypad input.
      - `edges` object[]: Transitions between nodes: `from` node, `to` node and the keypad input (or `timeout`/`*`) that triggers the transition.
        - `from` string
        - `to` string
        - `on` string
    - `error_message` AsyncFailureInfo: Why an accepted message failed asynchronously. Present only on failed messages (voice status `PROCESS_FAILED`, sms status `process_failed`).
      - `code` string: Failure code (e.g. voice `VOI_502`, sms `SMS_108`).
      - `message` string: Failure message.
    - `error_msg` string: The same failure information serialized as a JSON string.
  - `status` string

## Other responses

- `401`: Access Denied (`TM_4001`) - missing or invalid API token.
- `403`: Request Denied (`TM_3601`) - no call exists with the given message id.

---

[API](https://skmtc.dev/zoho/apis/zoho-cpaas.md) - [All operations](https://skmtc.dev/zoho/apis/zoho-cpaas/llms.txt) - [OpenAPI document](https://skmtc.dev/zoho/apis/zoho-cpaas/revisions/f0858a38e8b0?raw)