Notifications

Get Notification Message Settings

Returns the in-site notification preferences for the "Messages" group — the per-event toggles shown under OnlyFans → Settings → Notifications → Site → Messages. Use the returned {code, value} pairs as input to Update Notification Settings. Requires permission api_notifications_read_settings.

https://public-api.fansmetric.com

GET/v1/{account_id}/notifications/settings/message

API keyBearer

Authorization

default

AuthorizationBearer <token>

Send your FansMetric API key as a Bearer token in the Authorization header.

In: header

Path Parameters

account_id*integer
OnlyFans numeric account ID.

Query Parameters

groupstring
OF notification group. Default 1 (the standard Messages group used by every account).

Response Fields

data[]array
Notification sections. Each section has code, name, and an items[] array of {code, name, value} toggles.
data[].items[].codestring
Toggle code — pass to Update Notification Settings to flip it.
data[].items[].valueboolean
Current state — true if the notification is enabled.
dataobject | array
Endpoint-specific payload. See the fields below for this route.
_meta._credits.usedinteger
Credits consumed by this request (currently always 1).
_meta._rate_limits.limit_minuteinteger
Maximum requests per minute for the organization.
_meta._rate_limits.remaining_minuteinteger
Remaining requests in the current minute window.
_meta._rate_limits.limit_dayinteger
Maximum requests per day for the organization.
_meta._rate_limits.remaining_dayinteger
Remaining requests in the current day window.

Field	Type	Description
data[]	array	Notification sections. Each section has `code`, `name`, and an `items[]` array of `{code, name, value}` toggles.
data[].items[].code	string	Toggle code — pass to Update Notification Settings to flip it.
data[].items[].value	boolean	Current state — `true` if the notification is enabled.
data	object \| array	Endpoint-specific payload. See the fields below for this route.
_meta._credits.used	integer	Credits consumed by this request (currently always `1`).
_meta._rate_limits.limit_minute	integer	Maximum requests per minute for the organization.
_meta._rate_limits.remaining_minute	integer	Remaining requests in the current minute window.
_meta._rate_limits.limit_day	integer	Maximum requests per day for the organization.
_meta._rate_limits.remaining_day	integer	Remaining requests in the current day window.

curl --request GET "https://public-api.fansmetric.com/v1/100000001/notifications/settings/message?group=sample_group" \
  --header "Authorization: Bearer YOUR_API_KEY"

Response

200

{"data":[0:{"code":"messages"
"name":"Messages"
"items":[0:{"code":"new_message"
"name":"New message"
"value":true
}
1:{"code":"tip_received"
"name":"Tip received"
"value":true
}
2:{"code":"ppv_unlocked"
"name":"Paid message unlocked"
"value":false
}
]
}
]
"_meta":{"_credits":{"used":1
}
"_rate_limits":{"limit_minute":1000
"remaining_minute":999
"limit_day":50000
"remaining_day":49999
}
}
}

Subscribe To User

Update Notification Settings