curl --request GET \
--url https://api.fanvue.com/v1/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/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/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 dynamic smart list
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.
curl --request GET \
--url https://api.fanvue.com/v1/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/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/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: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"
Path Parameters
Dynamic smart list UUID
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?