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 for a specific day. Requires permission api_schedules_counters.

https://public-api.fansmetric.com

GET/v1/{account_id}/schedules/counters

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
Earliest publish date (inclusive). YYYY-MM-DD. Defaults to today (UTC).
end_datestring
Latest publish date (inclusive). YYYY-MM-DD. Defaults to start_date + 30 days.
timezonestring
IANA timezone used to bucket items into days. Default UTC.

Response Fields

data.listobject
Map keyed by YYYY-MM-DD. Each value is a per-type count object (post, chat, stream). Days with no scheduled items are omitted.
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.list	object	Map keyed by `YYYY-MM-DD`. Each value is a per-type count object (`post`, `chat`, `stream`). Days with no scheduled items are omitted.
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/schedules/counters?start_date=2026-01-01%2000%3A00%3A00&end_date=2026-01-31%2023%3A59%3A59&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
}
}
}

List Scheduled Items

List Later Scheduled Chats