List Events
Lists identity-linked events, most recent first by default. Pass identifier for one person’s journey, or omit it to list an account’s events within a time range. Events have the same shape as the POST /events intake: attribution in context, identity in user.
Authorizations
An Account API key, an App API key, an account access token, an account-scoped user token, or a user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************. See Auth & API keys for how to get each one.
Query Parameters
Any hard identifier of the person: a person ID (prsn_*), user ID, email, phone number, or a tracking cookie value (wuid, anonymous ID, fbp/fbc/ttp/ga). Omit to list recent events for the account.
Account ID, prefixed biz_. Optional for account API keys; required for credentials that can access multiple accounts.
Start of the time range as an ISO 8601 timestamp. Required when identifier is omitted.
End of the time range as an ISO 8601 timestamp. Required when identifier is omitted; otherwise defaults to now.
Number of results to return from the start of the range.
x <= 500Return results after this cursor. Use page_info.end_cursor from the previous response to fetch the next page.
Return results before this cursor. Use page_info.start_cursor from the previous response to fetch the previous page.
The order events are returned in by time. Defaults to desc (most recent first); asc reads a journey forwards from where it starts. after and before always page forwards and backwards through that order.
asc, desc Full event names to filter by, comma-separated (payment.completed, pixel.lead, pixel.page, pixel.custom:) — the same vocabulary the events / people metrics use.
Canonical source path, exact or with a trailing :* prefix (whop::, ext:meta:, referrer:, direct, unknown). Selects conversions credited to this source.
Attribution model for the source filter (defaults to last_touch).
last_touch, first_touch Country codes to filter by, comma-separated.
Cities to filter by, comma-separated.
Device families to filter by, comma-separated (e.g. iPhone, Mac).
Browser families to filter by, comma-separated (e.g. Chrome, Mobile Safari).
Operating system families to filter by, comma-separated (e.g. iOS, Windows).
utm_source values to filter by, comma-separated.
Page hostnames to filter by, comma-separated.
Page paths to filter by, comma-separated.

