API referenceEvents
List events
GET
The last 30 days. Message and conversation events are listed only for conversations the key’s member can see, and only when the key may read conversations.
ApiKeyheader
AuthorizationBearer <token>An API key from Developers → API keys: Authorization: Bearer gauge_live_… (or pulse_k_live_…).
limit?integerPage size, 1–100.
Range
1 <= value <= 100after?stringA nextCursor from the previous page.
before?stringA prevCursor, to page back. Not with after.
type?stringAn exact event type, or a family.* prefix.
since?stringOnly events at or after this instant.
Format
date-timeconversationId?stringOnly events about this conversation.
Format
uuidGauge-Version?stringA dated version. Default 2026-10-21.
A page of events, newest first.
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/events'Example Response
{ "nextCursor": "string", "prevCursor": "string", "data": [ { "id": "string", "type": "string", "conversationId": "ee6e55e8-45fe-4a3e-9bc8-4669f9fdf77a", "createdAt": "2019-08-24T14:15:22Z", "data": { "id": "string", "event": "string", "livemode": true, "workspaceId": "ef0efa32-d1c1-43d4-a5e2-fe7b4f00403c", "entity": "string", "entityId": "string", "occurredAt": "2019-08-24T14:15:22Z", "payload": { "property1": null, "property2": null } } } ]}