List per-creator-per-day subscriber events across all agency creators
Returns a single paginated stream of per-creator-per-day subscriber event rows across every creator the authenticated agency manages, sorted by most recent day first.
This endpoint is an analytics time series, not a real-time audience snapshot:
- newSubscribersCount = number of new subscription starts in the day bucket for the creator
- cancelledSubscribersCount = number of subscription chain ends in the day bucket for the creator
- total = cumulative net change for the creator from the beginning of the requested range (new - cancelled)
- renewalOnCount = auto-renewing (paid, recurring) subscriptions that started in the day bucket
- renewalOffCount = subscriptions whose auto-renewal was switched off in the day bucket
- freeTrialCount = free-trial subscriptions that started in the day bucket
- expiredCount = subscriptions that lapsed (expired) in the day bucket
newSubscribersCount/cancelledSubscribersCount/renewalOnCount/freeTrialCount/total are derived from paid invoices (immutable, stable across resubscriptions). renewalOffCount/expiredCount are derived from the subscriptions table (cancelled_at/deleted_at) — both fields are cleared on resubscribe, so these counts may be zero for subscriptions that were later reactivated. expiredCount may also differ slightly from cancelledSubscribersCount since they measure lapse from different sources.
If you need the current list of subscribers for messaging or CRM sync, use GET /agencies/subscribers instead. <Info>Requires: Agency admin access</Info>
Query parameters
Page number to retrieve (starts from 1)
Page number to retrieve (starts from 1)
Number of items to return per page (1-50, default: 15)
Number of items to return per page (1-50, default: 15)
Start of the date range (inclusive). UTC ISO 8601 datetime with offset.
Start of the date range (inclusive). UTC ISO 8601 datetime with offset.
End of the date range (exclusive). UTC ISO 8601 datetime with offset. Range must not exceed 365 days.
End of the date range (exclusive). UTC ISO 8601 datetime with offset. Range must not exceed 365 days.
Comma-separated list of creator UUIDs (max 50)
Comma-separated list of creator UUIDs to restrict results to a subset of the agency's managed creators (max 50)
Headers
API version to use for the request
Response
Paginated list of per-creator-per-day subscriber events across the agency's creators