curl --request GET \
--url https://api.fanvue.com/v1/creators/{creatorUserUuid}/chats/lists/smart \
--header 'Authorization: Bearer <token>' \
--header 'X-Fanvue-API-Version: <x-fanvue-api-version>'import requests
url = "https://api.fanvue.com/v1/creators/{creatorUserUuid}/chats/lists/smart"
headers = {
"X-Fanvue-API-Version": "<x-fanvue-api-version>",
"Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {
'X-Fanvue-API-Version': '<x-fanvue-api-version>',
Authorization: 'Bearer <token>'
}
};
fetch('https://api.fanvue.com/v1/creators/{creatorUserUuid}/chats/lists/smart', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));[
{
"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
},
{
"name": "Creators",
"uuid": "creators",
"count": 100
}
]{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}{
"message": "<string>"
}{
"error": "<string>",
"message": "<string>",
"nextVersion": "<string>"
}{
"error": "<string>"
}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:
subscribersfollowersauto_renewingnon_renewingexpired_subscribersfree_trial_subscribersspent_more_than_50
For subscribers, the count reflects current non-deleted subscription relationships that are contactable by the requested creator.
curl --request GET \
--url https://api.fanvue.com/v1/creators/{creatorUserUuid}/chats/lists/smart \
--header 'Authorization: Bearer <token>' \
--header 'X-Fanvue-API-Version: <x-fanvue-api-version>'import requests
url = "https://api.fanvue.com/v1/creators/{creatorUserUuid}/chats/lists/smart"
headers = {
"X-Fanvue-API-Version": "<x-fanvue-api-version>",
"Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {
'X-Fanvue-API-Version': '<x-fanvue-api-version>',
Authorization: 'Bearer <token>'
}
};
fetch('https://api.fanvue.com/v1/creators/{creatorUserUuid}/chats/lists/smart', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));[
{
"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
},
{
"name": "Creators",
"uuid": "creators",
"count": 100
}
]{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}{
"message": "<string>"
}{
"error": "<string>",
"message": "<string>",
"nextVersion": "<string>"
}{
"error": "<string>"
}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
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"
Path Parameters
Response
List of smart lists
Display name of the smart list
Smart list unique identifier
subscribers, auto_renewing, non_renewing, followers, free_trial_subscribers, expired_subscribers, spent_more_than_50, muted, creators Number of members in this list
Was this page helpful?