Fansly API LogoFansly API
Chats

Get Fan Chats Tips

List tips sent by a specific fan.

Get all tips sent by a specific fan to your account. It is particularly useful when you need to review a fan's tipping activity, verify recent transactions within a chat, or build out engagement features based on their tip history.

https://v1.apifansly.com/api/fansly
GET
/{account_id}/chats/{fan_id}/tips

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/{fan_id}/tips" \
  -H "x-api-key: YOUR_API_KEY"
fetch("https://v1.apifansly.com/api/fansly/{account_id}/chats/{fan_id}/tips", {
  method: "GET",
  headers: {
    "x-api-key": "YOUR_API_KEY"
  }
})
import requests

url = "https://v1.apifansly.com/api/fansly/{account_id}/chats/{fan_id}/tips"
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/{fan_id}/tips"))
        .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/{fan_id}/tips");
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/{fan_id}/tips"
    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.
fan_id*
string
The unique identifier (userId) of the fan.

Response

{
    "statusCode": 200,
    "message": "Success",
    "data": {
        "status_code": 200,
        "data": {
            "success": true,
            "response": [
                {
                    "id": "tip_id_string",
                    "senderId": "sender_account_id_string",
                    "receiverId": "receiver_account_id_string",
                    "amount": 100, //in cents
                    "message": "tip_message_string", 
                    "createdAt": 1773701871
                }
            ]
        }
    },
    "timestamp": "2026-05-18T12:00:00.000Z"
}

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
├─ successbooleanIndicates whether the request was successful
└─ responsearrayA list of tip objects sent by the fan
├─ idstringThe unique identifier for the tip
├─ senderIdstringThe account ID of the fan who sent the tip
├─ receiverIdstringThe account ID of the user who received the tip
├─ amountnumberThe amount of the tip
├─ messagestringThe message attached to the tip
└─ createdAtnumberUnix timestamp of when the tip was sent
timestampstringThe ISO 8601 timestamp of when the response was generated

On this page