Events API

/events exposes event-level lead and sale rows for troubleshooting conversion pipelines and customer journeys.

Endpoint

Method	Path	Purpose
`GET`	`/events`	List lead/sale events in workspace scope

Param	Type	Notes
`type`	`lead \| sale`	Optional filter. Any other value returns `400`.
`linkId`	`string`	Optional link-level filter.
`customerId`	`string`	Optional customer filter.
`start`	`date/datetime`	Optional start bound. Date-only values are normalized to `00:00:00`.
`end`	`date/datetime`	Optional end bound. Date-only values are normalized to `23:59:59`.
`page`	`number`	Default `1`.
`limit`	`number`	Default `50`, max `100`.
`sortBy`	`string`	Allowed: `timestamp`, `event_type`, `event_name`, `amount_in_usd`, `country`, `customer_external_id`.
`sortOrder`	`asc \| desc`	Optional sort direction.

Read responses are snapshot-cached for short TTL windows to reduce repeated analytics fetches while preserving near-real-time usability.

Related docs: