---
title: "List voicemail playbacks"
method: GET
path: "/voicemail_playbacks"
tags: ["Voicemail-Playbacks"]
---

# List voicemail playbacks

`GET /voicemail_playbacks`

## Request

- Base URL: `https://api.commpeak.com/portal`
- URL: `https://api.commpeak.com/portal/voicemail_playbacks`
- Auth: API key in header `Authorization`

Returns the account's voicemail playbacks: the greetings played to callers before a voicemail is recorded on a DID number. A playback is used for the DID numbers it is assigned to directly (`did_numbers`) or through DID tags (`did_number_tags`); the `default` playback is used for all other DID numbers. `send_to` lists the email addresses recorded voicemails are sent to.

## Response `200`

Successful Response

- VoicemailPlaybacksResponse: Envelope returned by `GET /portal/voicemail_playbacks`.
  - `voicemail_playbacks` VoicemailPlaybackItem[], required
    - `id` integer, required: Playback identifier.
    - `name` string, nullable: Name.
    - `default` boolean, nullable: Whether this is the account default playback.
    - `send_to` string[], nullable: Email addresses recorded voicemails are sent to.
    - `did_numbers` string[], nullable: DID numbers the playback is assigned to.
    - `did_number_tags` DIDNumberTag[], nullable: DID tags the playback is assigned to.
      - `id` integer, required: DID tag identifier.
      - `name` string, nullable: DID tag name.

---

[API](https://skmtc.dev/commpeak/apis/commpeak-portal-api.md) - [All operations](https://skmtc.dev/commpeak/apis/commpeak-portal-api/llms.txt) - [OpenAPI document](https://skmtc.dev/commpeak/apis/commpeak-portal-api/revisions/df57b0c16367?raw)