latestOpenAPI 3.1.02026-08-08243131.9 MB

c5ddcd5c7e72

Get notifications feed

Returns a paginated list of notifications for the authenticated user, ordered by most recent first. Optionally filter by event type.

<Info> **Polling for real-time updates? Use a webhook instead.**

If you are calling this endpoint on a schedule to detect new activity, subscribe to webhooks instead — most engagement and payment activity in this feed (messages, follows, likes, comments, subscriptions, and payments) is delivered in real time by the individual webhook events. See the full event catalogue in the webhook documentation. Some system notifications (promotions, account health, poll results, and fan churn risk) have no webhook equivalent yet and remain available only from this endpoint. </Info>

get/notifications

Query parameters

limitinteger

Number of results to return (default 20)

Number of results to return (default 20)

cursorstring

Cursor for pagination

Cursor for pagination

eventTypeinteger

Filter notifications by event type id

Filter notifications by event type id

Headers

X-Fanvue-API-Versionstring required
Example:2025-06-26

API version to use for the request

Response

List of notifications

nextCursorstring nullable required

Cursor for the next page, or null if none