curl --request GET \
--url https://api.fanvue.com/v1/creators/{creatorUserUuid}/chats/lists/dynamic/{uuid} \
--header 'Authorization: Bearer <token>' \
--header 'X-Fanvue-API-Version: <x-fanvue-api-version>'import requests
url = "https://api.fanvue.com/v1/creators/{creatorUserUuid}/chats/lists/dynamic/{uuid}"
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/creators/{creatorUserUuid}/chats/lists/dynamic/{uuid}', 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": "💰",
"definition": {
"version": 2,
"match": "any",
"groups": [
{
"conditions": [
{
"dimension": "total_spent",
"operator": "gte",
"value": 5000
}
]
}
]
},
"createdAt": "2026-01-15T10:00:00.000Z",
"updatedAt": "2026-01-20T10:00:00.000Z"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}{
"message": "<string>"
}{
"error": "<string>",
"message": "<string>",
"nextVersion": "<string>"
}{
"error": "<string>"
}Get a creator's dynamic smart list
Dynamic smart lists are user-created, filter-defined audience segments — distinct from the read-only, system-generated /lists/smart cohorts and from the static, manually-curated /lists/custom lists. A dynamic smart list’s membership is computed from a stored filter definition and is re-evaluated on read. Spend condition values are in USD cents (e.g. 5000 for $50).
This resource requires the creator’s dynamic smart list builder to be enabled; a 403 response means it is not.
curl --request GET \
--url https://api.fanvue.com/v1/creators/{creatorUserUuid}/chats/lists/dynamic/{uuid} \
--header 'Authorization: Bearer <token>' \
--header 'X-Fanvue-API-Version: <x-fanvue-api-version>'import requests
url = "https://api.fanvue.com/v1/creators/{creatorUserUuid}/chats/lists/dynamic/{uuid}"
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/creators/{creatorUserUuid}/chats/lists/dynamic/{uuid}', 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": "💰",
"definition": {
"version": 2,
"match": "any",
"groups": [
{
"conditions": [
{
"dimension": "total_spent",
"operator": "gte",
"value": 5000
}
]
}
]
},
"createdAt": "2026-01-15T10:00:00.000Z",
"updatedAt": "2026-01-20T10:00:00.000Z"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}{
"message": "<string>"
}{
"error": "<string>",
"message": "<string>",
"nextVersion": "<string>"
}{
"error": "<string>"
}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
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
Dynamic smart list
Dynamic smart list UUID
Display name
Optional icon identifier
Show child attributes
Show child attributes
When the list was created
When the list definition was last updated
Was this page helpful?