FMFansMetric API

Schedules

List Scheduled Items

Returns the creator's unified scheduled-items feed — posts, chats (DMs and mass messages), and streams that are queued for a future publish time, all in one list. This is the data the OnlyFans webapp's Schedule tab paints onto its calendar, scoped to a date window. Different from [List Mass Message Queue](/api-reference/mass-messages/queue), which only returns mass-message queue items — /schedules is the cross-type calendar view. Requires permission api_schedules_list.

https://public-api.fansmetric.com
GET/v1/{account_id}/schedules
Bearer

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.

  • timezonestring

    IANA timezone used to bucket items into days (e.g. Europe/Prague, Asia/Kolkata). Default UTC.

  • typestring

    Filter to one or more item types: chat, post, stream. Either repeat the param (type=chat&type=post) or pass a comma-separated list (type=chat,post).

  • limitinteger

    Page size. Default 20. Min 1, max 100.

  • offsetinteger

    Rows to skip. Default 0.

curl --request GET "https://public-api.fansmetric.com/v1/acct_XXXXX/schedules?start_date=sample_start_date&end_date=sample_end_date&timezone=sample_timezone" \
  --header "Authorization: Bearer YOUR_API_KEY"

Response

200
{
"data":{
"list":[
0:{
"id":123
"type":"chat"
"publishDateTime":"2026-06-10T15:00:00+00:00"
"createdDateTime":"2026-06-02T10:00:00+00:00"
"entity":{
"responseType":"message"
"id":456
"text":"<p>Hi!</p>"
"rawText":"Hi!"
"price":0
"isFree":true
"media":[]
"previews":[]
"scheduledAt":"2026-06-10T15:00:00+00:00"
"userLists":[
0:"fans"
]
"sentRulesType":"list"
"sentRulesExtra":"Fans"
"isFromQueue":true
"queueId":789
"canUnsendQueue":true
"unsendSecondsQueue":1000000
}
}
1:{
"id":124
"type":"post"
"publishDateTime":"2026-06-11T09:00:00+00:00"
"createdDateTime":"2026-06-02T11:00:00+00:00"
"entity":{
"responseType":"post"
"id":555
"text":"Drop tomorrow"
"rawText":"Drop tomorrow"
"canDelete":true
"canEdit":true
"isMediaReady":true
}
}
]
"syncInProcess":false
"hasMore":false
}
"_pagination":{
"next_page":null
}
"_meta":{
"_credits":{
"used":1
}
"_rate_limits":{
"limit_minute":1000
"remaining_minute":999
"limit_day":50000
"remaining_day":49999
}
}
}

Previous

Cancel Mass Message

Next

Get Schedule Counters