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

## Request

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

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