List conversations
Only what this key’s member may see (their own / team scope, unassigned pull queue, collaborations).
ApiKeyAuthorizationBearer <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.
status?stringComma-separated: open, snoozed, resolved.
channel?stringComma-separated channel kinds (whatsapp_cloud, whatsapp_web, email, webchat, …).
connectionId?stringOne connection.
assignee?stringme, none (unassigned) or a member id.
teamId?stringThe team handling it (Move to team, else its routing).
topicId?stringA topic.
appId?stringAn App.
integrationId?stringAn App integration.
contactId?stringOne contact’s conversations.
tag?stringTagged with this tag.
unread?stringtrue / false: customer messages newer than this key’s member last read.
updatedSince?stringISO-8601. Changed at or after.
priorityMin?stringMinimum priority score.
priorityMax?stringMaximum priority score.
sort?stringDefault -lastMessageAt.
"createdAt""-createdAt""lastMessageAt""-lastMessageAt"Gauge-Version?stringA dated version. Default 2026-10-21.
A page of conversations.
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/api/v2/conversations'{ "nextCursor": "string", "prevCursor": "string", "data": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "status": "open", "snoozedUntil": "string", "channel": "string", "connectionId": "84b500d7-71c8-4b1f-adf4-f1eb0000973d", "contact": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "displayName": "string" }, "assigneeId": "665a9750-71bd-4b96-bacd-9efa4ae022dd", "teamId": "a4ede8ba-7c0a-4485-8763-cbd9b282fbec", "topicId": "97b608a9-302e-4387-a5f4-fd35969cdc21", "appId": "28c365d5-df94-4a54-8217-3ce51d068868", "integrationId": "497a18ca-284e-40c0-985d-f72be35d468e", "tags": [ "string" ], "priority": 0, "unread": true, "needsReply": true, "lastMessageAt": "string", "lastInboundAt": "string", "createdAt": "string", "updatedAt": "string" } ]}