---
title: "List voice calls"
method: GET
path: "/api/phone/voice-calls"
tags: ["Voice Calls"]
---

# List voice calls

`GET /api/phone/voice-calls`

List voice calls matching the given parameters, paginated, and ordered.

## Query parameters

- `cursor` string
- `limit` integer
- `ticket_id` integer

## Response `200`

List of voice calls according to the given criteria.

- object
  - `meta` object, required — Pagination metadata for the list.
    - `next_cursor` string, nullable, required — Value indicating a cursor for the next page.
    - `prev_cursor` string, nullable, required — Value indicating a cursor for the previous page.
  - `object` string, required — Describes the object type of the payload.
  - `uri` string, url, required — Contains the URI of the fetched resource list.
  - `data` VoiceCall[], required
    - `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)