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

# List voice call recordings

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

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

## Query parameters

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

## Response `200`

List of voice call recordings according to the given criteria.

- VoiceCallRecording[]
  - `id` integer — ID of the voicemail or call recording.
  - `call_id` integer — ID of the voice call the voicemail or call recording belongs to.
  - `external_id` string — ID of the voicemail or call recording on the provider side (Twilio, etc...).
  - `url` string — Voicemail or call recording direct access URL.
  - `duration` integer — Duration in seconds of the voicemail or call recording.
  - `type` 'call-recording' | 'voicemail' — Whether this is a voicemail or a call recording.
  - `created_datetime` string, date-time — When the voicemail or call recording was created.
  - `deleted_datetime` string, date-time — When the voicemail or call recording was deleted, if deleted.
  - `deleted_by_user_id` integer — Which agent deleted the voicemail or call recording, if deleted.
  - `error_code` 'RECORDING_IS_PRIVATE', nullable — Reason why the URL could not be provided.
  - `transcription_status` string — The status of the transcription of the voicemail or call recording.

---

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