List Chats
List the creator's chats. Proxies Fanvue's GET /v1/chats and returns its body unchanged, including the nextCursor to page with and the total where Fanvue computes one.
Authorization
default Get your API Key from OnlyFansAPI Console - https://app.onlyfansapi.com/api-keys
In: header
Path Parameters
The Fanvue Account ID
Query Parameters
Opaque pagination cursor from a previous response's nextCursor.
Number of chats to return (1 - 50). Default = 15
Filters to apply: unread, subscribers, followers, online, recent_subscribers, not_answered, spent_more_than_50, on_free_trial, has_tipped, spenders, exclude_creators, subscribed_to, not_muted, muted, archived.
Fanvue smart list ids to filter by: subscribers, auto_renewing, non_renewing, followers, free_trial_subscribers, expired_subscribers, spent_more_than_50, muted, creators.
Restrict the list to these fan user UUIDs.
Filter chats by a Fanvue custom list UUID.
Search term matched against the fan's name or handle (max 100 characters).
Sort order: most_recent_messages, online_now or most_unanswered_chats.
Sort direction: asc or desc.
Response Body
application/json
curl -X GET "https://app.onlyfansapi.com/api/fanvue/fanvue_acct_XXXXXXXXXXXXXXX/chats?cursor=eyJ2IjoxfQ&size=15&filter=unread&smartListIds=subscribers&userUuids=f47ac10b-58cc-4372-a567-0e02b2c3d479&customListId=9c1f5f22-1c3e-4b2a-8a0f-2b6c5d4e3f21&search=jane&sortBy=most_recent_messages&sortDirection=desc"{
"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."
}
}
}