Get retention cohorts
GET /v1/projects/{id}/retention
Returns player retention cohort data showing day-1, day-7, and day-30 retention rates for each cohort date within the specified time period.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ”Project UUID.
Query Parameters
Section titled “Query Parameters ”Time period in days.
Responses
Section titled “ Responses ”Array of retention cohorts.
object
Retention data for a single cohort (players who first appeared on cohort_date).
object
Date the cohort was formed (YYYY-MM-DD).
Example
2024-01-15Number of unique players in this cohort.
Players who returned on day 1.
Players who returned on day 7.
Players who returned on day 30.
Day-1 retention percentage (0-100).
Day-7 retention percentage (0-100).
Day-30 retention percentage (0-100).
Headers
Section titled “Headers ”Maximum number of requests allowed per hour.
Number of requests remaining in the current window.
Unix timestamp when the rate limit window resets.
Invalid request parameters or body.
object
Human-readable error message.
Missing or invalid API key.
object
Human-readable error message.
Resource not found.
object
Human-readable error message.
Rate limit exceeded.
object
Human-readable error message.
Headers
Section titled “Headers ”Maximum number of requests allowed per hour.
Number of requests remaining in the current window.
Unix timestamp when the rate limit window resets.