---
title: "List voice call events"
method: GET
path: "/api/phone/voice-call-events"
tags: ["Voice Call Events"]
---

# List voice call events

`GET /api/phone/voice-call-events`

List voice call events matching the given parameters, paginated, and ordered.

## Query parameters

- `cursor` string
- `limit` integer
- `call_id` integer

## Response `200`

List of voice call events to the given criteria.

- VoiceCallEvent[]
  - `id` integer — ID of the event.
  - `type` 'phone-call-answered' | 'phone-call-ringing' | 'phone-call-dial-failed' | 'phone-call-agent-dialed' | 'incoming-phone-call' | 'outgoing-phone-call' | 'completed-phone-call' | 'call-recording' | 'missed-phone-call' | 'declined-phone-call' | 'call-ending-triggered' | 'voicemail-recording' | 'phone-call-conversation-started' | 'phone-call-forwarded-to-external-number' | 'phone-call-forwarded-to-gorgias-number' | 'phone-call-forwarded' | 'message-played' | 'outgoing-phone-call-connected' | 'child-call-not_answered' | 'phone-call-transfer-initiated' | 'phone-call-transfer-failed' | 'phone-call-enqueued' | 'phone-call-enqueue-skipped' | 'phone-call-dequeued' | 'phone-call-wrap-up-started' | 'phone-call-wrap-up-ended' | 'ivr-menu-presented' | 'ivr-option-selected' | 'phone-call-deflected-to-sms' | 'customer-field-conditional-evaluated' | 'monitoring-started' | 'monitoring-ended' | 'monitoring-updated' — The voice call event type.
  - `account_id` integer — ID of the account the event belongs to.
  - `call_id` integer — ID of the call for which the event happened.
  - `user_id` integer — ID of the agent related to the event.
  - `customer_id` integer — ID of the customer related to the event.
  - `created_datetime` string, date-time — When the event was created.
  - `meta` object — Data associated to the event.

---

[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)