List voicemails

GET

/api/v2/nova/voicemails

curl --request GET \
  --url 'https://api.sipstack.com/api/v2/nova/voicemails?page=1&limit=50' \
  --header 'x-api-key: <x-api-key>'

import requests

url = "https://api.sipstack.com/api/v2/nova/voicemails"

querystring = {"page":"1","limit":"50"}

headers = {"x-api-key": "<x-api-key>"}

response = requests.get(url, headers=headers, params=querystring)

print(response.json())

const url = 'https://api.sipstack.com/api/v2/nova/voicemails?page=1&limit=50';
const options = {method: 'GET', headers: {'x-api-key': '<x-api-key>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://api.sipstack.com/api/v2/nova/voicemails',
  params: {page: '1', limit: '50'},
  headers: {'x-api-key': '<x-api-key>'}
};

try {
  const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}

Returns your organization’s voicemail messages with an unread count. Requires calls:read. Transcript text is included; AI analysis (summary / sentiment) is intentionally not exposed on the public API.

Authorizations

apiKeyAuth

Parameters

Query Parameters

page

integer

default: 1 >= 1

limit

integer

default: 50 >= 1 <= 200

mailbox

string

extension_id

string

is_read

boolean

Responses

200

Voicemail list with an unread count.

application/json

object

success

boolean

data

Array<object>

A voicemail message. Transcript text is included read-only; AI analysis fields are not exposed on the public API.

object

string format: uuid

mailbox

string

extension_id

string

nullable

caller_number

string

nullable

caller_name

string

nullable

duration_seconds

integer

is_read

boolean

transcription

string

nullable

transcription_status

string

nullable

recorded_at

string format: date-time

nullable

created_at

string format: date-time

nullable

pagination

Page metadata returned by the paginated Developer API list endpoints. Per-endpoint limit defaults and caps vary (see each endpoint’s limit parameter). In keyset (cursor) mode page, total, and totalPages are null — walk pages via next_cursor instead.

object

page

integer

nullable

limit

Items per page (the default and maximum vary by endpoint).

integer

total

Total matching records across all pages (null in cursor mode).

integer

nullable

totalPages

integer

nullable

meta

object

unreadCount

integer

Example

{
  "data": [
    {
      "id": "8f3c1a2b-5d6e-4f7a-9b0c-1d2e3f4a5b6c",
      "mailbox": "1001",
      "extension_id": "1001",
      "caller_number": "+14165550100",
      "caller_name": "Jordan Lee",
      "duration_seconds": 18,
      "is_read": false,
      "transcription": "Hi, this is Jordan calling about my appointment on Thursday. Please give me a call back at your convenience. Thanks!",
      "transcription_status": "completed",
      "recorded_at": "2026-01-15T09:12:00.000Z",
      "created_at": "2026-01-15T09:12:03.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 25,
    "total": 143,
    "totalPages": 6
  }
}

401

Missing or invalid API key.

application/json

Inline error shape used by the messaging API and management endpoints.

object

success

boolean

error

string

Example

{
  "success": false,
  "error": "Recipient phone number (to) is required"
}

403

The key is missing the calls:read scope.

application/json

Inline error shape used by the messaging API and management endpoints.

object

success

boolean

error

string

Example

{
  "success": false,
  "error": "Recipient phone number (to) is required"
}