Fanvue API Documentation

curl https://api.fanvue.com/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 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 requesting creator.

Scope required: read:chat read:fan

Get all available smart lists 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 requesting creator. <Info>Scope required: `read:chat` `read:fan`</Info>

Authentication

AuthorizationBearer

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

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

410

Gone Error

429

Too Many Requests Error

Get smart lists

Authentication

Headers

Response

Errors