Chats
List Chats
Get the list of chats for an Account.
https://v1.apifansly.com/api/fansly
GET
/{account_id}/chats
Get Started
All requests to the Fansly API require an API Key. See the Authentication page for details.
curl -X GET "https://v1.apifansly.com/api/fansly/{account_id}/chats" \
-H "x-api-key: YOUR_API_KEY"fetch("https://v1.apifansly.com/api/fansly/{account_id}/chats", {
method: "GET",
headers: {
"x-api-key": "YOUR_API_KEY"
}
})import requests
url = "https://v1.apifansly.com/api/fansly/{account_id}/chats"
headers = {
"x-api-key": "YOUR_API_KEY"
}
response = requests.get(url, headers=headers)
print(response.json())import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://v1.apifansly.com/api/fansly/{account_id}/chats"))
.header("x-api-key", "YOUR_API_KEY")
.GET()
.build();
client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
.thenApply(HttpResponse::body)
.thenAccept(System.out::println)
.join();using System.Net.Http;
using System.Threading.Tasks;
var client = new HttpClient();
client.DefaultRequestHeaders.Add("x-api-key", "YOUR_API_KEY");
var response = await client.GetAsync("https://v1.apifansly.com/api/fansly/{account_id}/chats");
var responseString = await response.Content.ReadAsStringAsync();
Console.WriteLine(responseString);package main
import (
"fmt"
"io/ioutil"
"net/http"
)
func main() {
url := "https://v1.apifansly.com/api/fansly/{account_id}/chats"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Set("x-api-key", "YOUR_API_KEY")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := ioutil.ReadAll(resp.Body)
fmt.Println(string(body))
}Path Parameters
account_id*
stringThe unique identifier for the connected account.
Query Parameters
cursor ?
string | numberUsed for pagination to fetch the next set of results.
filter ?
stringFilter chats by user type. Options: `all` (default), `vips`, `followers`, `subscribers`.
subscriptionTierId ?
stringFilter chats by a specific subscription tier ID.
search ?
stringSearch for specific text within chat conversations or usernames.
sort ?
stringSort chats. Options: `newest` (default), `oldest`, `unread`.
Response
{
"statusCode": 200,
"message": "Success",
"data": {
"status_code": 200,
"data": {
"success": true,
"response": {
"data": [
{
"account_id": "account_id_string",
"groupId": "chat_group_id_string",
"partnerAccountId": "partner_account_id_string",
"partnerUsername": "partner_username_string",
"flags": 0,
"unreadCount": 0,
"subscriptionTierId": null,
"lastMessageId": "message_id_string",
"lastUnreadMessageId": null
}
],
"aggregationData": {
"accounts": [
{
"id": "account_id_string",
"username": "account_username_string",
"displayName": "account_display_name_string",
"flags": 0,
"version": 0,
"createdAt": 1629506202000,
"followCount": 0,
"subscriberCount": 0,
"statusId": 1,
"lastSeenAt": 1776628340000,
"about": "account_about_text_string...",
"avatar": {
"id": "avatar_id_string",
"location": "/account_id_string/avatar_id_string.jpeg",
"locations": [{"location": "https://cdn.example.com/..."}]
}
}
]
}
}
},
"nextCursor": "next_page_cursor_string"
},
"timestamp": "2026-04-19T16:47:11.017Z"
}Response Body
| Field | Type | Description |
|---|---|---|
statusCode | number | The HTTP status code of the response (e.g., 200) |
message | string | A human-readable message about the result |
data | object | The main response payload |
├─ status_code | number | The internal status code of the Fansly operation |
├─ nextCursor | string | null | The cursor for the next page of results |
└─ data | object | Nested data container |
└─ response | object | Container for the chat data |
├─ data | array | A list of chat objects |
│ ├─ account_id | string | The ID of the connected account |
│ ├─ groupId | string | The unique ID for the chat group. This is used as the chat_id in other endpoints. |
│ ├─ partnerAccountId | string | The ID of the recipient user |
│ ├─ partnerUsername | string | The username of the recipient |
│ ├─ flags | number | Internal bitwise flags for the chat |
│ ├─ unreadCount | number | Number of unread messages in this chat |
│ ├─ subscriptionTierId | string | null | Required subscription tier ID (if any) |
│ ├─ lastMessageId | string | null | The ID of the most recent message |
│ └─ lastUnreadMessageId | string | null | The ID of the last unread message |
└─ aggregationData | object | Supplementary data like account details |
└─ accounts | array | A list of account details corresponding to the chats |
├─ id | string | The ID of the account |
├─ username | string | The username of the account |
├─ displayName | string | The display name of the account |
└─ avatar | object | Avatar details |
timestamp | string | The ISO 8601 timestamp of when the response was generated |