latestOpenAPI 3.1.02026-08-08243131.9 MB

c5ddcd5c7e72

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>

get/agencies/subscribers-history

Query parameters

pageinteger

Page number to retrieve (starts from 1)

Page number to retrieve (starts from 1)

sizeinteger

Number of items to return per page (1-50, default: 15)

Number of items to return per page (1-50, default: 15)

startDatestring date-time required

Start of the date range (inclusive). UTC ISO 8601 datetime with offset.

Start of the date range (inclusive). UTC ISO 8601 datetime with offset.

endDatestring date-time required

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.

creatorUuidsstring[]

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

X-Fanvue-API-Versionstring required
Example:2025-06-26

API version to use for the request

Response

Paginated list of per-creator-per-day subscriber events across the agency's creators