Fanvue API Documentation

curl https://api.fanvue.com/creators/creatorUserUuid/chats/lists/smart \
     -H "X-Fanvue-API-Version: 2025-06-26" \
     -H "Authorization: Bearer <token>"

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

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.

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

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. <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

429

Too Many Requests Error

Get creator's smart lists

Authentication

Path parameters

Headers

Response

Errors