List cloud events

Lists the authenticated user's ingested events ordered by receivedAt descending. Payload is omitted from list responses; fetch the detail endpoint for it.

get/v1/events

Request

Base URL: / (relative, and the document was published on a file host, not at the API’s origin)
URL: /v1/events
Auth: HTTP bearer

Query parameters

sourcestring

Source.

Example:gmail

Filter by event source.

routingStatusstring

Routing status.

Example:routed

Filter by routing status.

sincestring

RFC3339 lower bound.

Example:2026-06-06T00:00:00Z

Only events received at or after this RFC3339 time.

untilstring

RFC3339 upper bound.

Example:2026-06-07T00:00:00Z

Only events received at or before this RFC3339 time.

limitinteger

Page size.

Example:100

Page size (1-500, default 100).

cursorstring

Pagination cursor.

Opaque cursor from a prior page's nextCursor.

Response

Event page.

nextCursorstring nullable

Opaque cursor for the next page; empty when exhausted.

Example response

{
  "events": [
    {
      "dedupeKey": "gmail:msg:msg_123",
      "eventType": "email.received",
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "matchedTaskCount": 1,
      "occurredAt": "2026-06-06T14:00:00Z",
      "receivedAt": "2026-06-06T14:00:02Z",
      "routedAt": "2026-06-06T14:00:09Z",
      "routingStatus": "routed",
      "source": "gmail",
      "sourceAccountId": "acct_google_primary",
      "sourceEventId": "evt_123",
      "subject": "Invoice #4821 dispute",
      "text": "Acme disputed invoice #4821."
    }
  ],
  "nextCursor": "2026-06-06T14:00:02.123456Z|0c0afab1-7f6f-4f0b-9d8e-1e58e8b0f111"
}

Changes

No operation changes recorded.