curl --request GET \
--url https://api.fanvue.com/v1/chats/lists/dynamic \
--header 'Authorization: Bearer <token>' \
--header 'X-Fanvue-API-Version: <x-fanvue-api-version>'import requests
url = "https://api.fanvue.com/v1/chats/lists/dynamic"
headers = {
"X-Fanvue-API-Version": "<x-fanvue-api-version>",
"Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {
'X-Fanvue-API-Version': '<x-fanvue-api-version>',
Authorization: 'Bearer <token>'
}
};
fetch('https://api.fanvue.com/v1/chats/lists/dynamic', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));[
{
"uuid": "6f1c8e2a-6b3e-4c9b-8f3a-7c1a2b3c4d5e",
"name": "Big spenders",
"icon": "💰",
"createdAt": "2026-01-15T10:00:00.000Z",
"updatedAt": "2026-01-20T10:00:00.000Z",
"membersCount": 128,
"membersCountExact": true,
"valid": true
}
]{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}{
"error": "<string>",
"message": "<string>",
"nextVersion": "<string>"
}{
"error": "<string>"
}Get dynamic smart lists
Dynamic smart lists are user-created, filter-defined audience segments — distinct from the read-only, system-generated /lists/smart cohorts (subscribers, followers, etc.) and from the static, manually-curated /lists/custom lists. A dynamic smart list’s membership is computed from a stored filter definition over relationship, spend, engagement, and memory dimensions, and is re-evaluated on read. Spend condition values are in USD cents (e.g. 5000 for $50).
This resource requires the account’s dynamic smart list builder to be enabled; a 403 response means it is not.
Returns every dynamic smart list owned by the authenticated account.
curl --request GET \
--url https://api.fanvue.com/v1/chats/lists/dynamic \
--header 'Authorization: Bearer <token>' \
--header 'X-Fanvue-API-Version: <x-fanvue-api-version>'import requests
url = "https://api.fanvue.com/v1/chats/lists/dynamic"
headers = {
"X-Fanvue-API-Version": "<x-fanvue-api-version>",
"Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {
'X-Fanvue-API-Version': '<x-fanvue-api-version>',
Authorization: 'Bearer <token>'
}
};
fetch('https://api.fanvue.com/v1/chats/lists/dynamic', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));[
{
"uuid": "6f1c8e2a-6b3e-4c9b-8f3a-7c1a2b3c4d5e",
"name": "Big spenders",
"icon": "💰",
"createdAt": "2026-01-15T10:00:00.000Z",
"updatedAt": "2026-01-20T10:00:00.000Z",
"membersCount": 128,
"membersCountExact": true,
"valid": true
}
]{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}{
"error": "<string>",
"message": "<string>",
"nextVersion": "<string>"
}{
"error": "<string>"
}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
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
API version to use for the request
"2025-06-26"
Response
List of dynamic smart lists
Dynamic smart list UUID
Display name
Optional icon identifier
When the list was created
When the list definition was last updated
Number of members currently matching this list's definition, or null if unresolved
Always true when membersCount is present: counts are exact. Kept for API compatibility
Whether the stored definition is still valid against current dimension flags
Was this page helpful?