API referenceVoice
List calls
GET
Calls the key's member can see in call history, newest first.
ApiKeyheader
AuthorizationBearer <token>An API key from Developers → API keys: Authorization: Bearer gauge_live_… (or pulse_k_live_…).
limit?stringPage size, 1–100 (default 25).
after?stringA nextCursor from the previous page. Opaque.
before?stringA prevCursor, to page back. Opaque. Not with after.
direction?stringinbound, outbound or internal.
state?stringringing, answered, completed, failed, no_answer or voicemail.
numberId?stringOnly calls on this number.
contactId?stringOnly calls with this contact.
since?stringStarted at or after (ISO-8601).
until?stringStarted before (ISO-8601).
Gauge-Version?stringA dated version. Default 2026-10-21.
A page of calls.
application/json- 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.
curl -X GET 'https://app.gauge.chat/backend/v2/calls'Example Response
{ "nextCursor": "string", "prevCursor": "string", "data": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "direction": "inbound", "state": "ringing", "numberId": "4960e75f-5738-4a19-bb92-2459f0660f6c", "from": "string", "to": "string", "contactId": "b5ec5d98-4bee-4da1-ad24-dde86346cb1d", "conversationId": "ee6e55e8-45fe-4a3e-9bc8-4669f9fdf77a", "assigneeId": "665a9750-71bd-4b96-bacd-9efa4ae022dd", "answeredByMemberId": "bcc15947-ddee-42bf-b360-9f990b07d2c4", "startedAt": "string", "answeredAt": "string", "endedAt": "string", "durationSecs": 0, "recording": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "available": true, "durationSecs": 0 } } ]}