Skip to main content
POST
Search events by filter criteria

Authorizations

Authorization
string
header
required

Use an Observe API key from the management console. The key selects the project and must grant the permission listed on the operation. Keep this key on your server.

Body

application/json
flowIDs
string[]
required

Flow IDs to fetch events for (format flw-<number>).

subFlowIDs
string[]

Optional exact subflow owners, intersected with flowIDs. Include descendant IDs explicitly for a subtree.

limit
integer
default:100

Maximum number of events to return. Defaults to 100, maximum 10000.

Required range: 1 <= x <= 10000

Response

Matching SDK tracking events in their original session order.

events
object[]
required

SDK tracking events for the selected flows, oldest first, capped at limit.

totalCount
integer
required

Total number of matching events regardless of limit