Voicemail API reference
Last updated: 2026-06-01
List, download, transcribe, and delete voicemail messages for an extension.
Required scope
voicemail:read, voicemail:write
Endpoints
| Method | Path | Description |
|---|---|---|
GET | /voicemail/list?extension=101 | List messages for an extension (new + saved). |
GET | /voicemail/download?id=vm_1 | Download the audio file. |
GET | /voicemail/transcript?id=vm_1 | Return the AI transcript. |
POST | /voicemail/mark_read | Mark a message as read. |
POST | /voicemail/delete | Delete a message. |
Common errors
40001— Missing or invalid parameter.40301— API key lacks the scope this endpoint requires.40401— Resource not found.50001— Internal error; safe to retry with backoff.