GET
/
api
/
{account}
/
notifications
List Notifications
curl --request GET \
  --url https://app.onlyfansapi.com/api/{account}/notifications \
  --header 'Authorization: Bearer <token>'
{
  "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
    }
  }
}

Authorizations

​
Authorization
string
header
required

You can retrieve your token by visiting the OnlyFansAPI Console and clicking API Keys -> Create API Key.

Path Parameters

​
account
string
required

The Account ID

Query Parameters

​
type
enum<string>

Filter notifications by a specific type

Available options:
all,
subscriptions,
onlyfans,
purchases,
tips,
tags,
comments,
mentions,
likes,
promotions
Example:

"tips"

​
limit
integer

The number of notifications. Default 10

Example:

10

​
from_id
integer

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

Example:

123

​
skip_users
enum<string>

Whether to skip user details. Default all

Available options:
all,
none
Example:

"all"

Response

200 - application/json

Success

The response is of type object.