---
title: "Retrieve a voice call"
method: GET
path: "/api/phone/voice-calls/{id}"
tags: ["Voice Calls"]
---

# Retrieve a voice call

`GET /api/phone/voice-calls/{id}`

## Path parameters

- `id` integer, required

## Response `200`

The requested voice call.

- VoiceCall — A voice call represents a phone call received from a customer (inbound) or addressed to a customer (outbound).
  - `id` integer, required — ID of the voice call.
  - `integration_id` integer, required — ID of the voice integration that managed the voice call.
  - `ticket_id` integer — ID of the ticket the voice call belongs to.
  - `phone_number_id` integer — ID of the phone number that received or performed the voice call.
  - `external_id` string, required — ID of the voice call on the provider side (Twilio, etc...).
  - `provider` string, required — The voice solutions provider handling the voice call. It provides the `external_id`.
  - `status` 'answered' | 'connected' | 'in-progress' | 'initiated' | 'queued' | 'ringing' | 'ending' | 'busy' | 'canceled' | 'completed' | 'failed' | 'no-answer' | 'missed', required — The current status of the voice call.
  - `direction` 'inbound' | 'outbound', required — Whether the voice call is received from a customer (inbound) or addressed to a customer (outbound).
  - `phone_number_source` string — The phone number performing the voice call.
  - `country_source` string — The country code of the phone number performing the voice call.
  - `phone_number_destination` string — The phone number receiving the voice call.
  - `country_destination` string — The country code of the phone number receiving the voice call.
  - `duration` integer — Duration in seconds of the voice call.
  - `started_datetime` string, date-time — When the voice call started on the provider side.
  - `created_datetime` string, date-time, required — When the voice call was created in Gorgias.
  - `updated_datetime` string, date-time — When the voice call was last updated.
  - `initiated_by_agent_id` integer — The agent that initiated the voice call, only for outbound calls.
  - `last_answered_by_agent_id` integer — The last agent that answered the voice call.
  - `customer_id` integer — For inbound calls, the customer that initiated the voice call.For outbound calls, the customer that received the voice call.
  - `last_rang_agent_id` integer — The last agent that received the voice call.
  - `has_voicemail` boolean — Whether the voice call has a voicemail attached.
  - `has_call_recording` boolean — Whether the voice call has a call recording attached.
  - `summaries` object[] — Summaries generated of the recordings of the voice call.
    - `id` integer, required — ID of the voice call.
    - `recording_id` integer, required — ID of the recording associated to the summary.
    - `summary` string, required — Summary of the voice call.
    - `created_datetime` string, date-time, required — When the summary was created.
  - `termination_status` 'answered' | 'cancelled' | 'missed' | 'abandoned' | 'callback-requested' — The termination status of the voice call.
  - `queue_id` integer — ID of the voice queue that managed the voice call.
  - `status_in_queue` string — Sub-status of the voice call when status is Queued
  - `answered_by_external_number` string — The external phone number that answered the voice call when forwarded externally.
  - `answered_by_external_customer_id` integer — The customer associated with the external number that answered the voice call.
  - `monitoring_status` 'listening' | 'whispering' | 'none', nullable — Which type of monitoring is being currently performed on the call, if any.
  - `last_monitoring_agent_id` integer, nullable — The id of the last agent that was monitoring the call.

---

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