curl --request GET \
--url https://api.fanvue.com/v1/creators/{creatorUserUuid}/chats/mass-messages \
--header 'Authorization: Bearer <token>' \
--header 'X-Fanvue-API-Version: <x-fanvue-api-version>'import requests
url = "https://api.fanvue.com/v1/creators/{creatorUserUuid}/chats/mass-messages"
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/mass-messages', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"data": [
{
"uuid": "a1b2c3d4-5e6f-7g8h-9i0j-k1l2m3n4o5p6",
"text": "Big news for my subscribers ❤️",
"status": "SENT",
"price": 500,
"createdAt": "2024-01-15T00:00:00.000Z",
"publishedAt": "2024-01-15T00:00:00.000Z",
"scheduledAt": null,
"recipientCount": 1200,
"viewCount": 830,
"purchaseCount": 145,
"totalRevenue": 72500,
"mediaUuids": [
"a1b2c3d4-5e6f-7g8h-9i0j-k1l2m3n4o5p6"
],
"includedLists": {
"smartListIds": [
"subscribers"
],
"smartListUuids": [
"subscribers"
],
"customListUuids": []
},
"excludedLists": {
"smartListIds": [],
"smartListUuids": [],
"customListUuids": []
}
}
],
"nextCursor": "k0FQ1m9yZXN0aWdpb3VzLW9wYXF1ZS1jdXJzb3I"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}{
"message": "<string>"
}{
"error": "<string>",
"message": "<string>",
"nextVersion": "<string>"
}{
"error": "<string>"
}List mass messages for a creator (cursor-paginated)
Returns a cursor-paginated list of mass (broadcast) messages sent by the specified creator, most recent first, including delivery and engagement statistics.
Each item includes recipient count, view count, purchase count, and total revenue generated.
Use the includeDeleted query parameter to also retrieve deleted (unsent) mass messages. Deleted messages will have a status of UNSENT.
v1-experimental Breaking Change: Switched from offset-based pagination (page/size) to keyset cursor pagination. Page with the opaque nextCursor; keyset pagination stays stable under concurrent sends, unlike the offset-paginated v0 endpoint.
curl --request GET \
--url https://api.fanvue.com/v1/creators/{creatorUserUuid}/chats/mass-messages \
--header 'Authorization: Bearer <token>' \
--header 'X-Fanvue-API-Version: <x-fanvue-api-version>'import requests
url = "https://api.fanvue.com/v1/creators/{creatorUserUuid}/chats/mass-messages"
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/mass-messages', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"data": [
{
"uuid": "a1b2c3d4-5e6f-7g8h-9i0j-k1l2m3n4o5p6",
"text": "Big news for my subscribers ❤️",
"status": "SENT",
"price": 500,
"createdAt": "2024-01-15T00:00:00.000Z",
"publishedAt": "2024-01-15T00:00:00.000Z",
"scheduledAt": null,
"recipientCount": 1200,
"viewCount": 830,
"purchaseCount": 145,
"totalRevenue": 72500,
"mediaUuids": [
"a1b2c3d4-5e6f-7g8h-9i0j-k1l2m3n4o5p6"
],
"includedLists": {
"smartListIds": [
"subscribers"
],
"smartListUuids": [
"subscribers"
],
"customListUuids": []
},
"excludedLists": {
"smartListIds": [],
"smartListUuids": [],
"customListUuids": []
}
}
],
"nextCursor": "k0FQ1m9yZXN0aWdpb3VzLW9wYXF1ZS1jdXJzb3I"
}{
"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.
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
Query Parameters
Opaque pagination cursor from a previous response's nextCursor
Number of items to return (1-50, default: 15)
1 <= x <= 50Whether to include deleted (unsent) mass messages in the results. Defaults to false.
true, false Was this page helpful?