Skip to main content
GET
/
chats
/
lists
/
smart
/
{uuid}
Get smart list members
curl --request GET \
  --url https://api.fanvue.com/chats/lists/smart/{uuid} \
  --header 'Authorization: Bearer <token>' \
  --header 'X-Fanvue-API-Version: <x-fanvue-api-version>'
{
  "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
  }
}

Authorizations

​
Authorization
string
header
required

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

Headers

​
X-Fanvue-API-Version
string
default:2025-06-26
required

API version to use for the request

Example:

"2025-06-26"

Path Parameters

​
uuid
enum<string>
required

Smart list unique identifier

Available options:
subscribers,
auto_renewing,
non_renewing,
followers,
free_trial_subscribers,
expired_subscribers,
spent_more_than_50,
muted

Query Parameters

​
page
number
default:1

Page number to retrieve (starts from 1)

Required range: x >= 1
​
size
number
default:15

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

Required range: 1 <= x <= 50

Response

Smart list members

​
data
object[]
required

Members of the smart list

​
pagination
object
required

Pagination information