FMFansMetric API

Notifications

List Notifications

Returns notifications with cursor-based pagination. Filterable by category. Requires permission api_notifications_list.

https://public-api.fansmetric.com
GET/v1/{account_id}/notifications
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

  • limitinteger

    Number of items. Default 10. Min 1, max 100.

  • typestring

    Filter by category. Values: subscribed, paided_message, purchases, tip, tags, commented, mentioned, favorited, message, system, deactivated_media. Omit for all.

  • from_idinteger

    Cursor — last notification ID from previous page.

curl --request GET "https://public-api.fansmetric.com/v1/acct_XXXXX/notifications?limit=20&type=all&from_id=sample_from_id" \
  --header "Authorization: Bearer YOUR_API_KEY"

Response

200
{
"data":{
"list":[
0:{
"id":100000000006
"type":"subscribed"
"createdAt":"2026-05-17T14:49:00+00:00"
"isRead":true
}
]
"hasMore":true
}
"_pagination":{
"next_page":"/v1/100000001/notifications?limit=10&from_id=100000000007"
}
"_meta":{
"_credits":{
"used":1
}
"_rate_limits":{
"limit_minute":1000
"remaining_minute":987
"limit_day":50000
"remaining_day":49987
}
}
}

Previous

List Chat Lists

Next

Auth