---
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}`

## Request

- Base URL: `https://your-domain.gorgias.com`
- URL: `https://your-domain.gorgias.com/api/phone/voice-call-recordings/{id}`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/gorgias/apis/gorgias-rest-api/docs/api/phone/voice-call-recordings/:id/get.ts> (a function with typed inputs; its response is checked against the schema)

## 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.dev/gorgias/apis/gorgias-rest-api.md) - [All operations](https://skmtc.dev/gorgias/apis/gorgias-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gorgias/apis/gorgias-rest-api/revisions/3fdfcb5b6678?raw)