List mass messages for a creator | Fanvue API Documentation

import requests
url = "https://api.fanvue.com/creators/creatorUserUuid/chats/mass-messages"
headers = {
    "X-Fanvue-API-Version": "2025-06-26",
    "Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.json())

{
  "data": [
    {
      "uuid": "d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f90",
      "text": "Hey everyone! Check out my new exclusive content 🔥",
      "status": "SENT",
      "price": 500,
      "createdAt": "2024-01-15T00:00:00.000Z",
      "publishedAt": "2024-01-15T00:00:00.000Z",
      "recipientCount": 1250,
      "viewCount": 890,
      "purchaseCount": 156,
      "totalRevenue": 78000
    },
    {
      "uuid": "e5f6a7b8-c9d0-1e2f-3a4b-5c6d7e8f9012",
      "text": "Good morning! Hope you all have a great day ☀️",
      "status": "SENT",
      "price": 1.1,
      "createdAt": "2024-01-14T00:00:00.000Z",
      "publishedAt": "2024-01-14T00:00:00.000Z",
      "recipientCount": 1180,
      "viewCount": 720,
      "purchaseCount": 0,
      "totalRevenue": 0
    }
  ],
  "pagination": {
    "page": 1,
    "size": 2,
    "hasMore": true
  }
}

Returns a paginated list of mass (broadcast) messages sent by the specified creator, 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.

Scopes required: read:creator, read:chat

Returns a paginated list of mass (broadcast) messages sent by the specified creator, 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`. <Info>Scopes required: `read:creator`, `read:chat`</Info>

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

creatorUserUuidstringRequiredformat: "uuid"

Headers

X-Fanvue-API-VersionstringRequiredDefaults to 2025-06-26

API version to use for the request

Query parameters

pagedoubleOptional>=1Defaults to 1

Page number to retrieve (starts from 1)

sizedoubleOptional1-50Defaults to 15

Number of items to return per page (1-50, default: 15)

includeDeletedenumOptionalDefaults to false

Whether to include deleted (unsent) mass messages in the results. Defaults to false.

Allowed values:

Response

List of mass messages with statistics

datalist of objects

Array of mass messages with delivery and engagement statistics

paginationobject

Pagination information

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

410

Gone Error