Skip to main content
GET
Pull public events

Authorizations

Authorization
string
header
required

Sign in with the existing Occtoo Studio identity and selected organization.

Query Parameters

after
string

Opaque cursor returned by the previous pull page, or the raw fixed-width sequence of the last successfully processed event for recovery. Events at or before the supplied position are excluded. Omit it to begin at the earliest retained event.

limit
default:100

Maximum number of events to return. The default is 100 and the maximum is 1,000.

total
boolean
default:false

When true, includes the exact number of events matching the tenant, after cursor and filter before the page limit. The count is omitted by default because it requires scanning all matches.

filter
string

RFC 7644-derived event filter. Supports eq, and, or, parentheses and double-quoted strings. Example: (type eq "source.updated" and sourceId eq "products") or (type eq "segment.updated" and segmentId eq "summer-sale"). Filterable properties are listed by GET /v1/event-types.

Maximum string length: 4096

Response

An ordered page of tenant events and its continuation cursor.

A finite page from the ordered tenant event stream.

items
object[]
required

Structured CloudEvents in ascending sequence order.

after
string
required

Opaque continuation cursor to send with the next request.

Example:

"MDAzLjAwMDAwMDAwMDAwMDAwMTg0NDY3"

hasMore
boolean
required

Whether another matching event was available when this page was read.

Example:

true

total

Exact matching count when total=true; omitted otherwise.

Example:

42