---
title: "Get voice log"
method: GET
path: "/api/voice/logs/{id}"
tags: ["Voice Logs"]
---

# Get voice log

`GET /api/voice/logs/{id}`

Find a log by ID.

#### Permissions

The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Voice_.

[Learn more about API scopes](/docs/platform/your-signalwire-api-space).

## Path parameters

- `id` string, uuid, required — Universal Unique Identifier.

## Response `200`

Response model for voice log retrieve endpoint

- union — A voice log entry. The specific fields present depend on the `type` value. Discarded logs return only `id`, `discarded_at`, and `created_at`.
  - VoiceRelayVoiceLog — Voice log for Compatibility and Relay call types. Returned when `type` is `laml_call`, `relay_pstn_call`, `relay_sip_call`, or `relay_webrtc_call`.
    - `id` string, uuid, required — Universal Unique Identifier.
    - `from` string, required — The origin phone number.
    - `to` string, required — The destination phone number.
    - `source` 'dialogflow' | 'laml' | 'realtime_api', required
    - `charge` number, double, required — The charge in dollars.
    - `charge_details` VoiceChargeDetail[], required — Details on charges associated with this log.
      - `description` string, required — Description for this charge.
      - `charge` number, double, required — Charged amount.
    - `created_at` string, date-time, required — Date and time when the call entry was created.
    - `type` 'laml_call' | 'relay_pstn_call' | 'relay_sip_call' | 'relay_webrtc_call', required
    - `url` string, uri, nullable, required — URL for the resource associated with this log entry. Present for LAML calls, null for Relay calls.
    - `direction` 'inbound' | 'outbound' | 'outbound-api' | 'outbound-dial', required
    - `status` 'queued' | 'initiated' | 'ringing' | 'in-progress' | 'busy' | 'failed' | 'no-answer' | 'canceled' | 'completed' | 'ended' | 'answered' | 'created' | 'ending' | 'joined', required
    - `duration` integer, nullable, required — The duration of the voice activity in seconds.
    - `duration_ms` integer, nullable, required — The duration of the voice activity in milliseconds.
    - `billing_ms` integer, nullable, required — The billable duration of the voice activity in milliseconds.
    - `parent_id` string, nullable, required — Parent log identifier for related call entries.
  - VoiceVideoRoomVoiceLog — Voice log for audio legs in a Video Room. Returned when `type` is `video_room_pstn_leg` or `video_room_sip_leg`.
    - `id` string, uuid, required — Universal Unique Identifier.
    - `from` string, required — The origin phone number.
    - `to` string, required — The destination phone number.
    - `source` 'dialogflow' | 'laml' | 'realtime_api', required
    - `charge` number, double, required — The charge in dollars.
    - `charge_details` VoiceChargeDetail[], required — Details on charges associated with this log.
      - `description` string, required — Description for this charge.
      - `charge` number, double, required — Charged amount.
    - `created_at` string, date-time, required — Date and time when the call entry was created.
    - `type` 'video_room_pstn_leg' | 'video_room_sip_leg', required
    - `url` unknown, required
    - `direction` 'inbound' | 'outbound' | 'outbound-api' | 'outbound-dial', required
    - `status` 'queued' | 'initiated' | 'ringing' | 'in-progress' | 'busy' | 'failed' | 'no-answer' | 'canceled' | 'completed' | 'ended' | 'answered' | 'created' | 'ending' | 'joined', required
    - `duration` integer, nullable, required — The duration of the voice activity in seconds.
    - `duration_ms` integer, nullable, required — The duration of the voice activity in milliseconds.
  - VoiceDialogflowVoiceLog — Voice log for Dialogflow call types. Returned when `type` is `dialogflow_call`.
    - `id` string, uuid, required — Universal Unique Identifier.
    - `from` string, required — The origin phone number.
    - `to` string, required — The destination phone number.
    - `source` 'dialogflow' | 'laml' | 'realtime_api', required
    - `charge` number, double, required — The charge in dollars.
    - `charge_details` VoiceChargeDetail[], required — Details on charges associated with this log.
      - `description` string, required — Description for this charge.
      - `charge` number, double, required — Charged amount.
    - `created_at` string, date-time, required — Date and time when the call entry was created.
    - `type` 'dialogflow_call', required — Type of this log entry.
    - `url` unknown, required
    - `status` 'queued' | 'initiated' | 'ringing' | 'in-progress' | 'busy' | 'failed' | 'no-answer' | 'canceled' | 'completed' | 'ended' | 'answered' | 'created' | 'ending' | 'joined', required
    - `duration` integer, nullable, required — The duration of the voice activity in seconds.
  - VoiceFabricVoiceLog — Voice log for Fabric Subscriber Device call types. Returned when `type` is `fabric_subscriber_device_leg`.
    - `id` string, uuid, required — Universal Unique Identifier.
    - `from` string, required — The origin phone number.
    - `to` string, required — The destination phone number.
    - `source` 'dialogflow' | 'laml' | 'realtime_api', required
    - `charge` number, double, required — The charge in dollars.
    - `charge_details` VoiceChargeDetail[], required — Details on charges associated with this log.
      - `description` string, required — Description for this charge.
      - `charge` number, double, required — Charged amount.
    - `created_at` string, date-time, required — Date and time when the call entry was created.
    - `type` 'fabric_subscriber_device_leg', required — Type of this log entry.
    - `url` unknown, required
    - `direction` 'inbound' | 'outbound' | 'outbound-api' | 'outbound-dial', required
    - `status` 'queued' | 'initiated' | 'ringing' | 'in-progress' | 'busy' | 'failed' | 'no-answer' | 'canceled' | 'completed' | 'ended' | 'answered' | 'created' | 'ending' | 'joined', required
  - VoiceDiscardedVoiceLog — A discarded/deleted voice log entry. Returned when the log has been deleted. Only present when `include_deleted` is `true`.
    - `id` string, uuid, required — Universal Unique Identifier.
    - `discarded_at` string, date-time, required — Date and time when the log was discarded.
    - `created_at` string, date-time, required — Date and time when the log was originally created.

## Other responses

- `400` — The request is invalid.
- `401` — Access is unauthorized.
- `404` — The server cannot find the requested resource.
- `422` — The request contains invalid parameters. See errors for details.
- `500` — An internal server error occurred.

---

[API](https://skmtc.net/signalwire/apis/signalwire-rest-api.md) · [All operations](https://skmtc.net/signalwire/apis/signalwire-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/signalwire/signalwire-rest-api/versions/05c5164b85c7/schema)