---
title: "Retrieve voicemail message list"
method: GET
path: "/v2/partition/{partitionId}/account/{accountId}/voicemailbox/{voicemailBoxId}/voicemailmessage"
tags: ["Voicemail Message"]
---

# Retrieve voicemail message list

`GET /v2/partition/{partitionId}/account/{accountId}/voicemailbox/{voicemailBoxId}/voicemailmessage`

## Request

- Base URL: `https://api.alianza.com`
- URL: `https://api.alianza.com/v2/partition/{partitionId}/account/{accountId}/voicemailbox/{voicemailBoxId}/voicemailmessage`
- Auth: API key in header `X-AUTH-TOKEN`

Use to retrieve a list of voicemail messages in a voicemail box

## Path parameters

- `accountId` string, required
- `partitionId` string, required
- `voicemailBoxId` string, required

## Response `200`

Successful operation

- VoicemailMessageX[]
  - `id` string
  - `createdDate` string, date-time: date the message was left
  - `fromName` string: callerId name of caller that left message, if available
  - `fromNumber` string: callerId number of caller that left message, if available
  - `lengthInPages` integer: length of message in pages, if it is a FAX
  - `lengthInSeconds` integer: length of message in pages, if it is a VOICE message
  - `read` boolean: has the message been seen / opened / read
  - `sizeInBytes` integer: size of message in bytes
  - `messageType` 'FAX' | 'VOICE': type of message
  - `voicemailBoxId` string: voicemail box id
  - `accountId` string: Account of the voicemail box
  - `partitionId` string: Partition of the account
  - `toPhoneNumber` string: The to number associated with the voicemail message
  - `transcriptionStatus` string: The status of the transcription
  - `transcriptionInfo` string: Details (quality, etc...) about the transcription
  - `transcriptionText` string: The resulting text of the transcribed message
  - `storageId` string, uuid: The storage id of audio file
  - `audioFileAndType` string: The type of audio file

## Other responses

- `400`: Invalid request
- `401`: Unauthorized
- `404`: Not found

---

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