GaugeAPI docs
GuidesAPI referenceChangelogOpen console
API referenceVoice

List voicemails

GET
/v2/voicemails

Authorization

ApiKey
headerAuthorizationBearer <token>

An API key from Developers → API keys: Authorization: Bearer gauge_live_… (or pulse_k_live_…).

Query Parameters

limit?string

Page size, 1–100 (default 25).

after?string

A nextCursor from the previous page. Opaque.

before?string

A prevCursor, to page back. Opaque. Not with after.

numberId?string

Only voicemails on this number.

listened?string

true or false.

Header Parameters

Gauge-Version?string

A dated version. Default 2026-10-21.

Response Body

A page of voicemails, newest first.

application/json
  1. response

A cursor page over (created_at, id). Every list returns this shape.

data*array<>
nextCursor*|

Pass as after for the next page; null on the last page.

prevCursor*|

Pass as before for the previous page; null on the first page.

Example Request
curl -X GET 'https://app.gauge.chat/backend/v2/voicemails'
Example Response
{  "nextCursor": "string",  "prevCursor": "string",  "data": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "callId": "4722cd84-0ec7-4ef5-8c34-1b0150f45f53",      "numberId": "4960e75f-5738-4a19-bb92-2459f0660f6c",      "from": "string",      "contactId": "b5ec5d98-4bee-4da1-ad24-dde86346cb1d",      "conversationId": "ee6e55e8-45fe-4a3e-9bc8-4669f9fdf77a",      "durationSecs": 0,      "listened": true,      "receivedAt": "string",      "audio": {        "url": "http://example.com",        "expiresAt": "string",        "contentType": "string",        "sizeBytes": 0      }    }  ]}

List numbers GET

The numbers the key's member may use: every number for a voice manager, otherwise their assigned numbers and the shared ones.

Create a webhook endpoint POST

Starts sending the chosen events to `url`. The response carries the signing `secret` ONCE. The endpoint receives only conversations the key’s member can see. Subscribing to message, conversation or contact events also needs `messages:read`, `conversations:read` or `contacts:read` on the key. For WhatsApp Web connections you are responsible for send volume and the ban risk. Deliveries are at-least-once: dedupe on the event `id` (also in `Gauge-Event-Id`). Order is NOT guaranteed, not even within one conversation — use `occurredAt` and the snapshot in the payload. A non-2xx answer is retried after 30 s, 5 min, 1 h and 6 h. An endpoint failing every delivery for 3 days is switched off and its owner is told.