Get retention cohorts
Person-grain retention cohorts. Each person is anchored to the cohort of their ALL-TIME first recorded activity, so start_date and end_date select which cohorts come back, not what counts as acquisition. Every cohort carries one row per elapsed period with the persons active in it, the retention rate, and the revenue those persons recorded.
Activity retention only: a person counts as retained for ANY activity in the period. Event-specific retention, such as returned and purchased, is not available in this version and is not approximated.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
Inclusive first cohort date, as YYYY-MM-DD or an ISO 8601 instant. Supply with end_date; omit both for the last 90 days of cohorts.
Inclusive last cohort date, as YYYY-MM-DD or an ISO 8601 instant.
Cohort bucket and period unit. Weeks start Monday.
day, week, month Highest period index returned, counted in granularity units from period 0.
1 <= x <= 24Response
Successful response. Activity retention: a person counts as retained for any activity in the period, not for a specific event.
One entry per cohort, oldest first. Empty when no cohort falls in the range.
day, week, month Always true on a 200. A failed read is a 503, never an empty cohort grid.