List mass messages | Fanvue API Documentation

curl https://api.fanvue.com/chats/mass-messages \
     -H "X-Fanvue-API-Version: 2025-06-26" \
     -H "Authorization: Bearer <token>"

{
  "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 authenticated 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.

Scope required: read:chat

This endpoint is only available to creators.

Returns a paginated list of mass (broadcast) messages sent by the authenticated 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>Scope required: `read:chat`</Info> <Warning>This endpoint is only available to creators.</Warning>

Authentication

AuthorizationBearer

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

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

Authentication

Headers

Query parameters

Response

Errors