v8

latestOpenAPI 3.0.3raw.githubusercontent.com2026-05-2526602.8 MB
Notifications

List Notifications

List all notifications for the account

get/api/{account}/notifications

Query parameters

type'all' | 'subscriptions' | 'onlyfans' | 'purchases' | 'tips' | 'tags' | 'comments' | 'mentions' | 'likes' | 'promotions'

Filter notifications by a specific type

Example:comments

Filter notifications by a specific type

limitinteger

The number of notifications. Default 10

Example:10

The number of notifications. Default 10

from_idinteger

Used for pagination. This value should be the ID of the previous response's last notification.

Example:123

Used for pagination. This value should be the ID of the previous response's last notification.

skip_users'all' | 'none'

Whether to skip user details. Default all

Example:all

Whether to skip user details. Default all

Response

Success

Example response

{
  "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
    }
  }
}