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

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

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.

Response Fields

data.list[].idinteger
Notification ID.
data.list[].typestring
Notification type.
data.list[].createdAtstring
ISO 8601 timestamp.
data.list[].isReadboolean
Whether the notification has been marked read.
data.hasMoreboolean
Whether more pages exist.
_pagination.next_pagestring
Pre-built next-page URL with from_id.
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[].id	integer	Notification ID.
data.list[].type	string	Notification type.
data.list[].createdAt	string	ISO 8601 timestamp.
data.list[].isRead	boolean	Whether the notification has been marked read.
data.hasMore	boolean	Whether more pages exist.
_pagination.next_page	string	Pre-built next-page URL with `from_id`.
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/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
}
}
}

List Chat Lists

Auth