Skip to main content
GET
Get a creator's dynamic smart lists
Required scopes
  • read:creator — Access creator profiles, content, and creator-specific information.
  • read:chat — Read chat conversations, messages, and chat-related data. This includes viewing chat lists and message history.
  • read:fan — Access fan-related data and information within the platform.

Authorizations

Authorization
string
header
required

OAuth 2.0 access token, presented as a JWT bearer token in the Authorization header. Obtain a token via the authorization-code flow; the scopes granted to the token determine which operations it may call.

Headers

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

API version to use for the request

Example:

"2025-06-26"

Path Parameters

creatorUserUuid
string<uuid>
required

Response

List of dynamic smart lists

uuid
string<uuid>
required

Dynamic smart list UUID

name
string
required

Display name

icon
string | null
required

Optional icon identifier

createdAt
string<date> | null
required

When the list was created

updatedAt
string<date> | null
required

When the list definition was last updated

membersCount
number | null
required

Number of members currently matching this list's definition, or null if unresolved

membersCountExact
boolean | null
required

Always true when membersCount is present: counts are exact. Kept for API compatibility

valid
boolean
required

Whether the stored definition is still valid against current dimension flags