latestOpenAPI 3.1.02026-08-08243131.9 MB

c5ddcd5c7e72

Get creator's smart lists

Get all available smart lists for a specific creator with member counts.

Smart lists are system-generated dynamic audience segments (not user-created lists). They are computed from relationship/subscription/payment state and update automatically.

Examples include:

  • subscribers
  • followers
  • auto_renewing
  • non_renewing
  • expired_subscribers
  • free_trial_subscribers
  • spent_more_than_50

For subscribers, the count reflects current non-deleted subscription relationships that are contactable by the requested creator.

get/creators/{creatorUserUuid}/chats/lists/smart

Path parameters

creatorUserUuidstring uuid required

Headers

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

API version to use for the request

Response

List of smart lists

namestring required

Display name of the smart list

uuid'subscribers' | 'auto_renewing' | 'non_renewing' | 'followers' | 'free_trial_subscribers' | 'expired_subscribers' | 'spent_more_than_50' | 'muted' | 'creators' required

Smart list unique identifier

countnumber required

Number of members in this list