GET
/
api
/
{account}
/
mass-messaging
/
statistics
curl --request GET \
  --url https://app.onlyfansapi.com/api/{account}/mass-messaging/statistics \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": 123,
      "date": "2025-01-01T01:01:01+01:01",
      "text": "<p>Text</p>",
      "giphyId": null,
      "textCropped": "<p>Text</p>",
      "isFree": true,
      "sentCount": 123,
      "viewedCount": 123,
      "canUnsend": true,
      "unsendSeconds": 1000000,
      "isCanceled": false,
      "mediaTypes": null,
      "hasError": false,
      "releaseForms": []
    },
    {
      "id": 124,
      "date": "2025-01-01T01:01:01+01:01",
      "text": "<p>PPV Example</p>",
      "giphyId": null,
      "textCropped": "<p>PPV Example</p>",
      "isFree": false,
      "sentCount": 0,
      "viewedCount": 0,
      "canUnsend": false,
      "unsendSeconds": 0,
      "isCanceled": true,
      "mediaTypes": {
        "photo": 2
      },
      "hasError": false,
      "price": "5.00",
      "purchasedCount": 0,
      "canSendMessageToBuyers": false,
      "releaseForms": []
    }
  ],
  "_meta": {
    "_credits": {
      "used": 1,
      "balance": 999999990,
      "note": "Always"
    },
    "_cache": {
      "is_cached": false,
      "note": "Cache disabled for this endpoint"
    },
    "_rate_limits": {
      "limit_minute": 60,
      "limit_day": 500,
      "remaining_minute": 59,
      "remaining_day": 484
    }
  }
}

Authorizations

​
Authorization
string
header
required

You can retrieve your token by visiting the OnlyFansAPI Console and clicking API Keys -> Create API Key.

Path Parameters

​
account
string
required

The Account ID

Query Parameters

​
limit
integer

Number of mass messages to return (default = 20)

Example:

20

​
offset
integer

Number of mass messages to skip for pagination

Example:

0

​
query
string

Optionally, find a mass message by the message text.

Example:

"My message text"

​
type
enum<string>

Filter by sent / scheduled / unsent (default = sent)

Available options:
sent,
scheduled,
unsent
Example:

"sent"

Response

200 - application/json

The response is of type object.