πŸš€ Fansly API (Alpha) is live!WIP - Updated Daily
Fansly API Logo
Chat messages

List Chat Messages

Retrieve the message history for a specific chat.


Get the list of messages for a chat.

https://v1.apifansly.com
GET
/api/fansly/{account_id}/chats/{chat_id}/messages

The chat_id parameter corresponds to the groupId returned by the List Chats endpoint.

Get Started

All requests to the Fansly API require an API Key. See the Authentication page for details.

Path Parameters

curl -X GET "https://v1.apifansly.com/api/fansly/{account_id}/chats/{chat_id}/messages" \
  -H "x-api-key: YOUR_API_KEY"
fetch("https://v1.apifansly.com/api/fansly/{account_id}/chats/{chat_id}/messages", {
  method: "GET",
  headers: {
    "x-api-key": "YOUR_API_KEY"
  }
})
import requests

url = "https://v1.apifansly.com/api/fansly/{account_id}/chats/{chat_id}/messages"
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/{chat_id}/messages"))
        .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/{chat_id}/messages");
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/{chat_id}/messages"
    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))
}
account_id*
string
The unique identifier for the connected account.
chat_id*
string
The unique identifier for the chat.

Response

{
    "statusCode": 200,
    "message": "Success",
    "data": {
        "status_code": 200,
        "data": {
            "success": true,
            "response": {
                "messages": [
                    {
                        "id": "xxxxxxxxxxxxxxxx",
                        "type": 1,
                        "dataVersion": 1,
                    "content": "Hello form Fansly API 3",
                    "groupId": "854885651xxxxxxxxx",
                    "senderId": "854883131xxxxxxxxx",
                    "correlationId": "0",
                        "inReplyTo": null,
                        "inReplyToRoot": null,
                        "createdAt": 1768xxxxxxx,
                        "attachments": [],
                        "embeds": [],
                        "interactions": [
                            {
                                "userId": "8654079xxxxxxxx",
                                "readAt": 176877xxxxxxxxx,
                                "deliveredAt": 17687xxxxxxxx
                            }
                        ],
                        "likes": [],
                        "totalTipAmount": 0
                    },
                    {
                        "id": "8691224xxxxxxxxxxxx",
                        "type": 1,
                        "dataVersion": 1,
                        "content": "πŸ’¦β™‘Welcome to my corner!! Thank you for following me, I hope you have a nice stay here, I do personalized, dickrate and sexting!! Please drop that cum for me!! I am usually very friendly.",
                        "groupId": "8683242xxxxxxxx",
                        "senderId": "542982xxxxxxxx",
                        "correlationId": "8683xxxxxxxxxxxxx",
                        "inReplyTo": null,
                        "inReplyToRoot": null,
                        "createdAt": 176xxxxxxxx,
                        "attachments": [
                            {
                                "messageId": "86832426xxxxxxxx",
                                "contentType": 2,
                                "contentId": "6596572xxxxxxxx",
                                "pos": 0
                            },
                            {
                                "messageId": "8683242xxxxxxxx",
                                "contentType": 32001,
                                "contentId": "5571396xxxxxxxx",
                                "pos": 1
                            }
                        ],
                        "embeds": [],
                        "interactions": [
                            {
                                "userId": "86540xxxxxxxx",
                                "readAt": 1768xxxxxxxx,
                                "deliveredAt": 17685xxxxxxxx
                            }
                        ],
                        "likes": [],
                        "totalTipAmount": 0
                    }
                ]
            }
        }
    },
    "timestamp": "2026-01-19T17:10:50.635Z"
}

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
└─ dataobjectNested data container
└─ responseobjectContainer for the message data
└─ messagesarrayA list of message objects
β”œβ”€ idstringUnique identifier for the message
β”œβ”€ contentstringThe text content of the message
β”œβ”€ senderIdstringThe ID of the user who sent the message
β”œβ”€ createdAtnumberUnix timestamp of when the message was sent
β”œβ”€ attachmentsarrayA list of attached media or metadata
β”‚ β”œβ”€ contentTypenumberThe type of attachment
β”‚ └─ contentIdstringThe ID of the attached content
β”œβ”€ interactionsarrayDelivery and read status for users
β”‚ β”œβ”€ userIdstringThe ID of the user who interacted
β”‚ β”œβ”€ readAtnumberUnix timestamp of when the message was read
β”‚ └─ deliveredAtnumberUnix timestamp of when the message was delivered
└─ totalTipAmountnumberTotal amount tipped on this message
timestampstringThe ISO 8601 timestamp of when the response was generated

On this page