FanvueFans
List Online Fans
List the fans who are online right now, so chatters can prioritise them. Proxies Fanvue's GET /v1/chats with filter=online, so the entries are chats rather than bare users and carry the same shape as List Chats.
Authorization
default AuthorizationBearer <token>
Get your API Key from OnlyFansAPI Console - https://app.onlyfansapi.com/api-keys
In: header
Path Parameters
fanvueAccount*string
The Fanvue Account ID
Query Parameters
cursor?string
Opaque pagination cursor from a previous response's nextCursor.
size?integer
Number of chats to return (1 - 50). Default = 15
Response Body
application/json
curl -X GET "https://app.onlyfansapi.com/api/fanvue/fanvue_acct_XXXXXXXXXXXXXXX/fans/online?cursor=eyJ2IjoxfQ&size=15"{
"data": {
"data": [
{
"createdAt": "2026-09-22T10:29:07.400Z",
"lastMessageAt": "2026-09-22T10:46:04.712Z",
"isRead": true,
"unreadMessagesCount": 0,
"isMuted": false,
"user": {
"uuid": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"handle": "sarah-jones",
"displayName": "Sarah Jones",
"nickname": null,
"isTopSpender": false,
"avatarUrl": null,
"registeredAt": "2026-09-21T12:05:33.176Z"
},
"lastMessage": {
"sentAt": "2026-09-22T10:46:04.712Z",
"text": "See you tonight!",
"hasMedia": false,
"hasGif": false,
"type": "SINGLE_RECIPIENT",
"mediaType": null,
"uuid": "3b1f0a6c-92f1-4a58-9d0e-7c4b2a5f8d33",
"senderUuid": "3bbe6394-2830-4646-a8ba-4a0a05426947",
"senderRole": "CREATOR",
"sentByUserId": null,
"status": "Read"
},
"online": true,
"lastSeenAt": "2026-09-22T11:23:37.916Z",
"isCreator": false,
"customLists": []
}
],
"nextCursor": null,
"total": null
},
"_meta": {
"_credits": {
"used": 1,
"balance": 10055811,
"note": "Always"
},
"_cache": {
"is_cached": false,
"note": "Cache disabled for this endpoint"
},
"_rate_limits": {
"limit_minute": 5000,
"limit_day": null,
"remaining_minute": 4999,
"remaining_day": null,
"notice": "We have decided to remove our daily rate limits. Please remove any references to these in your integrations."
}
}
}