Skip to main content
GET
/
creators
/
{creatorUserUuid}
/
chats
/
lists
/
smart
Get creator's smart lists
curl --request GET \
  --url https://api.example.com/creators/{creatorUserUuid}/chats/lists/smart \
  --header 'Authorization: Bearer <token>' \
  --header 'X-Fanvue-API-Version: <x-fanvue-api-version>'
[
  {
    "name": "Subscribers",
    "uuid": "subscribers",
    "count": 1250
  },
  {
    "name": "Auto-renewing",
    "uuid": "auto_renewing",
    "count": 892
  },
  {
    "name": "Non-renewing",
    "uuid": "non_renewing",
    "count": 358
  },
  {
    "name": "Followers",
    "uuid": "followers",
    "count": 2156
  },
  {
    "name": "Free trial subscribers",
    "uuid": "free_trial_subscribers",
    "count": 45
  },
  {
    "name": "Expired subscribers",
    "uuid": "expired_subscribers",
    "count": 178
  },
  {
    "name": "Spent more than $50",
    "uuid": "spent_more_than_50",
    "count": 423
  },
  {
    "name": "Muted",
    "uuid": "muted",
    "count": 12
  }
]
Required scopes
  • read:creator — Access creator profiles, content, and creator-specific information.
  • read:chat — Read chat conversations, messages, and chat-related data. This includes viewing chat lists and message history.
  • read:fan — Access fan-related data and information within the platform.

Authorizations

​
Authorization
string
header
required

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

​
X-Fanvue-API-Version
string
default:2025-06-26
required

API version to use for the request

Example:

"2025-06-26"

Path Parameters

​
creatorUserUuid
string<uuid>
required

Response

List of smart lists

​
name
string
required

Display name of the smart list

​
uuid
enum<string>
required

Smart list unique identifier

Available options:
subscribers,
auto_renewing,
non_renewing,
followers,
free_trial_subscribers,
expired_subscribers,
spent_more_than_50,
muted
​
count
number
required

Number of members in this list