Get creator's smart list members | Fanvue API Documentation

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

{
  "data": [
    {
      "uuid": "550e8400-e29b-41d4-a716-446655440000",
      "displayName": "Sarah Johnson",
      "handle": "sarah_j",
      "isCreator": false
    },
    {
      "uuid": "550e8400-e29b-41d4-a716-446655440001",
      "displayName": "Mike Chen",
      "handle": "mike_creates",
      "isCreator": true
    },
    {
      "uuid": "550e8400-e29b-41d4-a716-446655440002",
      "displayName": "Alex Rivera",
      "handle": "alexr",
      "isCreator": false
    }
  ],
  "pagination": {
    "page": 1,
    "size": 20,
    "hasMore": true
  }
}

Get members of a specific smart list for a creator with pagination.

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

Get members of a specific smart list for a creator with pagination. <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"

uuidenumRequired

Smart list unique identifier

Query parameters

pagedoubleOptional>=1Defaults to 1

Page number to retrieve (starts from 1)

sizedoubleOptional1-50Defaults to 15

Number of items to return per page (1-50, default: 15)

Response

Smart list members

datalist of objects

Members of the smart list

paginationobject

Pagination information

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

410

Gone Error