Notifications
List Notifications
List all notifications for the account
AuthorizationBearer <token>
You can retrieve your token by visiting the OnlyFansAPI Console and clicking API Keys -> Create API Key.
In: header
Path Parameters
accountstring
The Account ID
Query Parameters
type?string
Filter notifications by a specific type
Value in
"all" | "subscriptions" | "onlyfans" | "purchases" | "tips" | "tags" | "comments" | "mentions" | "likes" | "promotions"limit?integer
The number of notifications. Default 10
from_id?integer
Used for pagination. This value should be the ID of the previous response's last notification.
skip_users?string
Whether to skip user details. Default all
Value in
"all" | "none"Response Body
curl -X GET "https://app.onlyfansapi.com/api/acct_XXXXXXXXXXXXXXX/notifications?type=tips&limit=10&from_id=123&skip_users=all"fetch("https://app.onlyfansapi.com/api/acct_XXXXXXXXXXXXXXX/notifications?type=tips&limit=10&from_id=123&skip_users=all")package main
import (
"fmt"
"net/http"
"io/ioutil"
)
func main() {
url := "https://app.onlyfansapi.com/api/acct_XXXXXXXXXXXXXXX/notifications?type=tips&limit=10&from_id=123&skip_users=all"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := ioutil.ReadAll(res.Body)
fmt.Println(res)
fmt.Println(string(body))
}import requests
url = "https://app.onlyfansapi.com/api/acct_XXXXXXXXXXXXXXX/notifications?type=tips&limit=10&from_id=123&skip_users=all"
response = requests.request("GET", url)
print(response.text)import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.http.HttpResponse.BodyHandlers;
import java.time.Duration;
HttpClient client = HttpClient.newBuilder()
.connectTimeout(Duration.ofSeconds(10))
.build();
HttpRequest.Builder requestBuilder = HttpRequest.newBuilder()
.uri(URI.create("https://app.onlyfansapi.com/api/acct_XXXXXXXXXXXXXXX/notifications?type=tips&limit=10&from_id=123&skip_users=all"))
.GET()
.build();
try {
HttpResponse<String> response = client.send(requestBuilder.build(), BodyHandlers.ofString());
System.out.println("Status code: " + response.statusCode());
System.out.println("Response body: " + response.body());
} catch (Exception e) {
e.printStackTrace();
}using System;
using System.Net.Http;
using System.Text;
var client = new HttpClient();
var response = await client.GetAsync("https://app.onlyfansapi.com/api/acct_XXXXXXXXXXXXXXX/notifications?type=tips&limit=10&from_id=123&skip_users=all");
var responseBody = await response.Content.ReadAsStringAsync();{
"data": {
"list": [
{
"id": 123,
"type": "subscribed",
"createdAt": "2025-01-01T00:00:00+00:00",
"isRead": true,
"text": "subscribed to your profile!",
"replacePairs": {
"{SUBSCRIBER_LINK}": "<a href='https://onlyfans.com/username'>Name</a>",
"{PRICE}": "free"
},
"subType": "new_subscriber_trial",
"canGoToProfile": true,
"user": {
"id": 123,
"_view": "n"
}
}
],
"hasMore": true
},
"_meta": {
"_credits": {
"used": 1,
"balance": 1000000015,
"note": "Always"
},
"_cache": {
"is_cached": false,
"note": "Cache disabled for this endpoint"
},
"_rate_limits": {
"limit_minute": 10000000,
"limit_day": 50000,
"remaining_minute": 9999999,
"remaining_day": 49973
}
}
}