Get Event Timeseries
Daily event count over the selected window.
filters to scope to a specific event, source, or location.
Set group_by to a breakdown dimension (channel_type, device, browser, os, location, referrer, ref, builder_codes, or any UTM column) to split the series by that dimension. When set, event_key carries the dimension’s value (empty → Direct) instead of the event type/name; the response keeps the top 100 values and buckets the rest as Others.
filters supports the string operators startsWith, endsWith, and contains (substring matches on text columns such as referrer, ref, utm_*) alongside the standard comparison operators. An unsupported operator now returns 400 Invalid query parameters rather than silently matching everything.Authorizations
Workspace API key (e.g. formo_xxx). Create one in the Formo dashboard under Team Settings > API.
Query Parameters
Inclusive start date (YYYY-MM-DD). Defaults to 7 days before date_to.
Inclusive end date (YYYY-MM-DD). Defaults to today.
Comma-separated list of event types to exclude from results (e.g. identify,detect).
Optional breakdown dimension. When set, event_key carries the dimension's value (empty → Direct) instead of the event type/name, so the series splits by that dimension. Top 100 values + Others.
channel_type, device, browser, os, location, referrer, ref, utm_source, utm_medium, utm_campaign, utm_content, utm_term, builder_codes Response
Event time-series
Analytics endpoint response. The data array contains the rows; the exact row shape depends on the endpoint. meta carries column type information for rendering, rows is the row count, and statistics holds query timing metadata.