---
title: "Retrieve a voice call recording"
method: GET
path: "/api/phone/voice-call-recordings/{id}"
tags: ["Voice Call Recordings"]
---

# Retrieve a voice call recording

`GET /api/phone/voice-call-recordings/{id}`

## Path parameters

- `id` integer, required

## Response `200`

The requested voice call recording.

- VoiceCallRecording — A voicemail left after a missed voice call, or a voice call recording.
  - `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)