List Events
Lists identity-linked events, most recent first. Pass identifier for one person's journey, or omit it to list events for an account within an explicit time range. Events are shaped like the POST /events intake: attribution in context, identity in user.
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.
The ID of the account, which will look like 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.
The number of events to return.
A cursor for fetching events after a previous page.
A cursor for fetching events before a later page.
Full event names to filter by, comma-separated (payment.completed, pixel.lead, pixel.page, pixel.custom:<name>) — the same vocabulary the events / people metrics use.
Canonical source path, exact or with a trailing :* prefix (whop:<campaign>:, ext:meta:, referrer:<domain>, direct). Restricts the list to conversion targets attributed to that source — the debuggability twin of a metric cell's source parameter.
Attribution model for the source filter (defaults to last_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.
Response
account events listed