Fansly API LogoFansly API
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*
string
The unique identifier for the connected account.

Query Parameters

cursor ?
string | number
Used for pagination to fetch the next set of results.
filter ?
string
Filter chats by user type. Options: `all` (default), `vips`, `followers`, `subscribers`.
subscriptionTierId ?
string
Filter chats by a specific subscription tier ID.
search ?
string
Search for specific text within chat conversations or usernames.
sort ?
string
Sort 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

FieldTypeDescription
statusCodenumberThe HTTP status code of the response (e.g., 200)
messagestringA human-readable message about the result
dataobjectThe main response payload
├─ status_codenumberThe internal status code of the Fansly operation
├─ nextCursorstring | nullThe cursor for the next page of results
└─ dataobjectNested data container
└─ responseobjectContainer for the chat data
├─ dataarrayA list of chat objects
│ ├─ account_idstringThe ID of the connected account
│ ├─ groupIdstringThe unique ID for the chat group. This is used as the chat_id in other endpoints.
│ ├─ partnerAccountIdstringThe ID of the recipient user
│ ├─ partnerUsernamestringThe username of the recipient
│ ├─ flagsnumberInternal bitwise flags for the chat
│ ├─ unreadCountnumberNumber of unread messages in this chat
│ ├─ subscriptionTierIdstring | nullRequired subscription tier ID (if any)
│ ├─ lastMessageIdstring | nullThe ID of the most recent message
│ └─ lastUnreadMessageIdstring | nullThe ID of the last unread message
└─ aggregationDataobjectSupplementary data like account details
└─ accountsarrayA list of account details corresponding to the chats
├─ idstringThe ID of the account
├─ usernamestringThe username of the account
├─ displayNamestringThe display name of the account
└─ avatarobjectAvatar details
timestampstringThe ISO 8601 timestamp of when the response was generated

On this page