latestOpenAPI 3.1.02026-08-08243131.9 MB

c5ddcd5c7e72

Get online subscribers

Returns subscribers who are currently online for the specified creator.

If subscriberUuids query parameter is provided, filters to only those specific subscribers. Otherwise returns all online subscribers up to limit.

<Info> **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.fan.status_changed webhook event instead — you'll get pushed updates in real time without polling. See the webhook documentation. </Info>

get/creators/{creatorUserUuid}/subscribers/online

Path parameters

creatorUserUuidstring uuid required

Query parameters

limitnumber

Maximum number of subscribers to return

Maximum number of subscribers to return

subscriberUuidsstring

Comma-separated list of subscriber UUIDs to filter (optional)

Comma-separated list of subscriber UUIDs to filter (optional)

Headers

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

API version to use for the request

Response

List of online subscribers

countnumber required

Total number of online subscribers returned