Get creator's custom list members | Fanvue API Documentation

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

{
  "data": [
    {
      "uuid": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
      "displayName": "Emma Thompson",
      "handle": "emma_art",
      "isCreator": true
    },
    {
      "uuid": "6ba7b811-9dad-11d1-80b4-00c04fd430c8",
      "displayName": "Jake Martinez",
      "handle": "jakethefan",
      "isCreator": false
    },
    {
      "uuid": "6ba7b812-9dad-11d1-80b4-00c04fd430c8",
      "displayName": "Sophie Williams",
      "handle": "sophie_w",
      "isCreator": true
    },
    {
      "uuid": "6ba7b813-9dad-11d1-80b4-00c04fd430c8",
      "displayName": "David Kim",
      "handle": "davidk_collector",
      "isCreator": false
    }
  ],
  "pagination": {
    "page": 1,
    "size": 20,
    "hasMore": false
  }
}

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

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

Get members of a specific custom 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"

uuidstringRequiredformat: "uuid"

Custom list UUID

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

Custom list members

datalist of objects

Members of the custom list

paginationobject

Pagination information

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

410

Gone Error