Read membership starts, ends, net change, and active counts per bucket. Use this report for your Telegram subscription bot or Discord subscription bot project.
API key scope:analytics:charts:read for restricted keys. Unrestricted project keys also support this endpoint.
Path Parameters
project_idstringrequired
Project UUID.
Query Parameters
fromstring
First UTC calendar day, YYYY-MM-DD; default to minus 29 days.
tostring
Last UTC calendar day inclusive, YYYY-MM-DD; default today.
intervalstring
day (default), week (ISO Monday start), or month (calendar).
Dates must be real calendar days between 2000-01-01 and 2099-12-31, with from no later than to and at most 366 days inclusive. Unknown query parameters are rejected. There is no request body. See the shared analytics date, money, and cache rules.
Future starts and ends are excluded. A membership ending at or before its start is ignored. Historical counts use rows that still exist and their current expiry dates, so this is not a complete record of past membership activity. Review the membership history limitations before drawing retention conclusions.