Get subscribers
Returns a paginated list of users who have subscriptions to the authenticated user.
Polling for real-time updates? Use a webhook instead.
If you are calling this endpoint on a schedule to detect new activity, subscribe to the creator.subscription.activated, creator.subscription.cancel_at_period_end_changed, creator.subscription.deactivated webhook events instead — you’ll get pushed updates in real time without polling. See the webhook documentation.
read:fan— Access fan-related data and information within the platform.
Authorizations
OAuth 2.0 access token, presented as a JWT bearer token in the Authorization header. Obtain a token via the authorization-code flow; the scopes granted to the token determine which operations it may call.
Headers
API version to use for the request
"2025-06-26"
Query Parameters
Page number to retrieve (starts from 1)
x >= 1Number of items to return per page (1-50, default: 15)
1 <= x <= 50Public field to sort by
name, subscribedAt Sort direction
asc, desc Only include users whose subscription started on or after this ISO 8601 datetime (e.g., 2024-10-20T00:00:00Z).
Only include users whose subscription started before this ISO 8601 datetime (non-inclusive).
Opaque pagination cursor from a previous response's pagination.nextCursor. When provided, page, sortField, sortDirection, startDate, and endDate are ignored (the cursor carries them); size applies when explicitly passed. Cursor pagination is more efficient than page-based pagination for iterating over large subscriber lists.