Get creator's smart lists | Fanvue API Documentation

import requests
url = "https://api.fanvue.com/creators/creatorUserUuid/chats/lists/smart"
headers = {
    "X-Fanvue-API-Version": "2025-06-26",
    "Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.json())

[
  {
    "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
  }
]

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

Scopes required: read:creator read:chat read:fan

Get all available smart lists for a specific creator with member counts. <Info>Scopes required: `read:creator` `read:chat` `read:fan`</Info>

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

creatorUserUuidstringRequiredformat: "uuid"

Response

List of smart lists

namestring

Display name of the smart list

uuidenum

Smart list unique identifier

countdouble

Number of members in this list

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

410

Gone Error

Authentication

Path parameters

Headers

Response

Errors