Mass Messages

Mass Message Chart

Returns a daily timeseries for mass (group) messages over a date window — one series of sent counts (group_messages.chart) and one series of $ purchased from those messages (group_messages_purchases.chart), each with the window total and the delta vs. the prior equal-length window. Aggregate chart view; for per-message rows use Mass Message Statistics. Requires permission api_mass_messages_read_chart.

https://public-api.fansmetric.com

GET/v1/{account_id}/mass-messages/chart

API keyBearer

Authorization

default

AuthorizationBearer <token>

Send your FansMetric API key as a Bearer token in the Authorization header.

In: header

Path Parameters

account_id*integer
OnlyFans numeric account ID.

Query Parameters

start_datestring
Window start. Default 30 days ago, UTC. YYYY-MM-DD HH:MM:SS or ISO 8601 (the T separator is normalized to a space).
end_datestring
Window end. Default end of today, UTC. Same format as start_date.

Response Fields

data.group_messages.chart[]array
One bucket per UTC day inclusive of the window. date is midnight UTC ISO 8601; count is the number of mass messages sent that day.
data.group_messages.totalnumber
Sum of group_messages.chart[].count over the window.
data.group_messages.deltanumber
total minus the total of the immediately preceding equal-length window. Positive = grew; negative = shrank.
data.group_messages_purchases.chart[]array
One bucket per UTC day in the window. count is the $ purchased from mass messages that day, in the account's payout currency.
data.group_messages_purchases.totalnumber
Sum of group_messages_purchases.chart[].count over the window — total $ from mass-message purchases.
data.group_messages_purchases.deltanumber
total minus the prior equal-length window's total.
dataobject | array
Endpoint-specific payload. See the fields below for this route.
_meta._credits.usedinteger
Credits consumed by this request (currently always 1).
_meta._rate_limits.limit_minuteinteger
Maximum requests per minute for the organization.
_meta._rate_limits.remaining_minuteinteger
Remaining requests in the current minute window.
_meta._rate_limits.limit_dayinteger
Maximum requests per day for the organization.
_meta._rate_limits.remaining_dayinteger
Remaining requests in the current day window.

Field	Type	Description
data.group_messages.chart[]	array	One bucket per UTC day inclusive of the window. `date` is midnight UTC ISO 8601; `count` is the number of mass messages sent that day.
data.group_messages.total	number	Sum of `group_messages.chart[].count` over the window.
data.group_messages.delta	number	`total` minus the total of the immediately preceding equal-length window. Positive = grew; negative = shrank.
data.group_messages_purchases.chart[]	array	One bucket per UTC day in the window. `count` is the $ purchased from mass messages that day, in the account's payout currency.
data.group_messages_purchases.total	number	Sum of `group_messages_purchases.chart[].count` over the window — total $ from mass-message purchases.
data.group_messages_purchases.delta	number	`total` minus the prior equal-length window's total.
data	object \| array	Endpoint-specific payload. See the fields below for this route.
_meta._credits.used	integer	Credits consumed by this request (currently always `1`).
_meta._rate_limits.limit_minute	integer	Maximum requests per minute for the organization.
_meta._rate_limits.remaining_minute	integer	Remaining requests in the current minute window.
_meta._rate_limits.limit_day	integer	Maximum requests per day for the organization.
_meta._rate_limits.remaining_day	integer	Remaining requests in the current day window.

curl --request GET "https://public-api.fansmetric.com/v1/100000001/mass-messages/chart?start_date=2026-01-01%2000%3A00%3A00&end_date=2026-01-31%2023%3A59%3A59" \
  --header "Authorization: Bearer YOUR_API_KEY"

Response

200

{"data":{"group_messages":{"chart":[0:{"date":"2026-05-09T00:00:00+00:00"
"count":50
}
1:{"date":"2026-05-10T00:00:00+00:00"
"count":49
}
]
"total":1446
"delta":-41.4
}
"group_messages_purchases":{"chart":[0:{"date":"2026-05-09T00:00:00+00:00"
"count":385.54
}
1:{"date":"2026-05-10T00:00:00+00:00"
"count":282.56
}
]
"total":9469.9
"delta":-18.1
}
}
"_meta":{"_credits":{"used":1
}
"_rate_limits":{"limit_minute":1000
"remaining_minute":999
"limit_day":50000
"remaining_day":49999
}
}
}

List Chargebacks

Create Post