FMFansMetric API

Chats

List Chats

Lists chat conversations for an OnlyFans account. Returned in real time from OnlyFans. Requires permission api_chats_list.

https://public-api.fansmetric.com
GET/v1/{account_id}/chats
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 chats to return. Default 10. Min 1, max 100.

  • offsetinteger

    Offset for pagination. Default 0.

  • skip_usersstring

    all (default) omits user objects in the response; none includes them.

  • orderstring

    recent (default) or old.

  • filterstring

    Filter chats: priority, pinned, unread, or who_tipped. Mutually exclusive with list_id.

  • list_idinteger

    Custom list ID (from GET /v1/{account_id}/lists). Mutually exclusive with filter.

  • querystring

    Search query — filters chats by username or display name.

curl --request GET "https://public-api.fansmetric.com/v1/acct_XXXXX/chats?limit=20&offset=0&skip_users=sample_skip_users" \
  --header "Authorization: Bearer YOUR_API_KEY"

Response

200
{
"data":{
"list":[
0:{
"withUser":{
"id":100000003
"_view":"..."
"username":"user_XXXXX"
"name":"User XX"
}
"lastMessage":{
"id":100000004
"text":"Hey there!"
"isFree":true
"createdAt":"2026-05-14T10:30:00+00:00"
"mediaCount":0
"isTip":false
"fromUser":{
"id":100000003
"_view":"..."
}
"isOpened":true
"giphyId":null
"lockedText":false
}
"canSendMessage":true
"canGoToProfile":true
"unreadMessagesCount":2
"lastReadMessageId":100000003
"hasUnreadTips":false
"isMutedNotifications":false
"hasPurchasedFeed":false
"countPinnedMessages":0
}
]
"hasMore":true
}
"_pagination":{
"next_page":"/v1/100000003/chats?limit=10&offset=10"
}
"_meta":{
"_credits":{
"used":1
}
"_rate_limits":{
"limit_minute":1000
"remaining_minute":998
"limit_day":50000
"remaining_day":49998
}
}
}

Previous

Get Current Account

Next

Hide Chat