OnlyFans API
Notifications

List Notifications

List all notifications for the account

GET
/api/{account}/notifications
AuthorizationBearer <token>

Get your API Key from OnlyFansAPI Console - https://app.onlyfansapi.com/api-keys

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/string/notifications?type=purchases&limit=10&from_id=123&skip_users=all"
{
  "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
    }
  }
}