List Mass Message Stats
List the account's sent broadcasts (newest first) with their statistics — or deleted broadcasts with deleted=true. These are the broadcasts shown on the Fansly dashboard's Broadcast Message Stats page.
For each message, stats.total is the number of recipients the broadcast could reach (not confirmed deliveries — permissions or long inactivity can prevent delivery) and stats.read is how many opened it. Fansly has no per-message purchase counter: we add attachmentSaleStats (sales, total, pending), summed from the saleStats of the message's attached media in accountMedia / accountMediaBundles, the same way the dashboard calculates it. Because those are the media's own sales, they also include purchases of the same media from other posts or mass messages, so summing them across broadcasts can double-count revenue.
To fetch the next page, pass the id of the last returned message as before.
A sent message's id is what the Unsend Sent Mass Message endpoint takes.
Authorization
default Get your API Key from OnlyFansAPI Console - https://app.onlyfansapi.com/api-keys
In: header
Path Parameters
The Fansly Account ID
Query Parameters
Pagination cursor: the id of the last message from the previous page. Omit (or pass 0) for the first page.
Number of broadcasts to return, 1–100. Defaults to 24.
List deleted broadcasts instead of sent ones.
Request Body
application/json
Must be at least 1. Must not be greater than 100.
Response Body
application/json
curl -X GET "https://app.fansapi.com/api/fansly/fansly_acct_XXXXXXXXXXXXXXX/mass-messaging/stats?before=0&limit=24&deleted=false" \ -H "Content-Type: application/json" \ -d '{}'{
"data": {
"messages": [
{
"id": "300000000000000040",
"type": 1,
"content": "Hey everyone, new content is live!",
"groupId": "200000000000000030",
"senderId": "800000000000000001",
"createdAt": 1785110912,
"attachments": [
{
"messageId": "300000000000000040",
"pos": 0,
"contentId": "500000000000000001",
"contentType": 1
}
],
"stats": {
"total": 1250,
"read": 430
},
"attachmentSaleStats": {
"sales": 12,
"total": 120000,
"pending": 0
}
}
],
"accountMedia": [
{
"id": "500000000000000001",
"accountId": "800000000000000001",
"mediaId": "800000000000000010",
"saleStats": {
"sales": 12,
"total": 120000,
"pending": 0
}
}
],
"accountMediaBundles": [],
"tips": [],
"tipGoals": []
},
"_meta": {
"_credits": {
"used": 1,
"balance": 10055789,
"note": "Always"
},
"_cache": {
"is_cached": false,
"note": "Cache disabled for this endpoint"
},
"_rate_limits": {
"limit_minute": 5000,
"limit_day": null,
"remaining_minute": 4999,
"remaining_day": null,
"notice": "We have decided to remove our daily rate limits. Please remove any references to these in your integrations."
}
}
}