Skip to main content
GET
/
creators
/
{creatorUserUuid}
/
chats
/
mass-messages
List mass messages for a creator
curl --request GET \
  --url https://api.fanvue.com/creators/{creatorUserUuid}/chats/mass-messages \
  --header 'Authorization: Bearer <token>' \
  --header 'X-Fanvue-API-Version: <x-fanvue-api-version>'
{
  "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",
      "scheduledAt": null,
      "recipientCount": 1250,
      "viewCount": 890,
      "purchaseCount": 156,
      "totalRevenue": 78000,
      "mediaUuids": [
        "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
      ]
    },
    {
      "uuid": "e5f6a7b8-c9d0-1e2f-3a4b-5c6d7e8f9012",
      "text": "Good morning! Hope you all have a great day ☀️",
      "status": "SENT",
      "price": null,
      "createdAt": "2024-01-14T00:00:00.000Z",
      "publishedAt": "2024-01-14T00:00:00.000Z",
      "scheduledAt": null,
      "recipientCount": 1180,
      "viewCount": 720,
      "purchaseCount": 0,
      "totalRevenue": 0,
      "mediaUuids": []
    }
  ],
  "pagination": {
    "page": 1,
    "size": 2,
    "hasMore": true
  }
}

Authorizations

​
Authorization
string
header
required

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

Headers

​
X-Fanvue-API-Version
string
default:2025-06-26
required

API version to use for the request

Example:

"2025-06-26"

Path Parameters

​
creatorUserUuid
string<uuid>
required

Query Parameters

​
page
number
default:1

Page number to retrieve (starts from 1)

Required range: x >= 1
​
size
number
default:15

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

Required range: 1 <= x <= 50
​
includeDeleted
enum<string>
default:false

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

Available options:
true,
false

Response

List of mass messages with statistics

​
data
object[]
required

Array of mass messages with delivery and engagement statistics

​
pagination
object
required

Pagination information