Schedules
Get Schedule Counters
Per-day counts of scheduled items across a date window, broken down by type. Powers the dots / badge numbers on the OnlyFans schedule calendar. Pull this once to know which days are non-empty before drilling into [List Scheduled Items](/api-reference/schedules/list-scheduled-items) for a specific day. Requires permission api_schedules_counters.
https://public-api.fansmetric.comGET/v1/{account_id}/schedules/counters
Bearer
Authorization
defaultAuthorizationBearer <token>Send your FansMetric API key as a Bearer token in the Authorization header.
In: header
Path Parameters
account_id*integerOnlyFans numeric account ID.
Query Parameters
start_datestringEarliest publish date (inclusive).
YYYY-MM-DD. Defaults to today (UTC).end_datestringLatest publish date (inclusive).
YYYY-MM-DD. Defaults tostart_date + 30 days.timezonestringIANA timezone used to bucket items into days. Default
UTC.
curl --request GET "https://public-api.fansmetric.com/v1/acct_XXXXX/schedules/counters?start_date=sample_start_date&end_date=sample_end_date&timezone=sample_timezone" \
--header "Authorization: Bearer YOUR_API_KEY"Response
200{
"data":{
"list":{
"2026-06-02":{
"post":1
"chat":2
}
"2026-06-05":{
"post":3
}
"2026-06-10":{
"chat":1
"stream":1
}
}
}
"_meta":{
"_credits":{
"used":1
}
"_rate_limits":{
"limit_minute":1000
"remaining_minute":999
"limit_day":50000
"remaining_day":49999
}
}
}