User retention cohorts by signup week.
Returns the retention cohort table the dashboard renders on the Retention page. Each row is a cohort; columns are subsequent activity buckets.Documentation Index
Fetch the complete documentation index at: https://docs.formo.so/llms.txt
Use this file to discover all available pages before exploring further.
Workspace API key (e.g. formo_xxx). Create one in the Formo dashboard under Team Settings > API Keys.
Inclusive start date (YYYY-MM-DD). Defaults to 7 days before date_to.
Inclusive end date (YYYY-MM-DD). Defaults to today.
User identifier to cohort by. address (default) groups by wallet; anonymous_id groups by anonymous session ID.
address, anonymous_id Restrict the cohort-defining event to a single type (e.g. page, connect, track, transaction).
Restrict the cohort-defining event to a custom event name. Combine with event_type=track.
Minimum cohort size to include (default 10). Ignored when user_filters is set - all weeks are returned regardless of size.
x >= 0Number of weekly cohorts to return (default 12). Also drives the default date range when date_from/date_to are omitted.
1 <= x <= 52Retention cohorts
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.