---
title: "Get notifications feed"
method: GET
path: "/notifications"
---

# Get notifications feed

`GET /notifications`

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](https://api.fanvue.com/docs/creator/overview). 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>

## Query parameters

- `limit` integer — Number of results to return (default 20)
- `cursor` string — Cursor for pagination
- `eventType` integer — Filter notifications by event type id

## Headers

- `X-Fanvue-API-Version` string, required

## Response `200`

List of notifications

- object
  - `data` object[], required — Array of notifications
    - `uuid` string, uuid, required
    - `createdAt` string, date-time, required
    - `eventType` integer, required — Numeric event id (6=post comment, 7=post like, 9=purchase, 10=new subscriber, 11=tip, 12=new follower, 14=promotion, 19=creator promo payment, 26=account health, 27=poll closed, 28=fan churn risk)
    - `isRead` boolean, required
    - `data` object, required — Event-specific payload. Shape varies by eventType.
    - `originator` object, nullable, required
      - `uuid` string, uuid, required
      - `handle` string, required
      - `displayName` string, required
      - `avatarUrl` string, nullable, required
      - `isCreator` boolean, required
    - `receiverUuid` string, uuid, required — UUID of the user who received the notification
  - `nextCursor` string, nullable, required — Cursor for the next page, or null if none

## Other responses

- `400` — Bad Request - API version not supported OR validation failed
- `401` — Unauthorized Response
- `403` — Unauthorized Response
- `410` — API version no longer supported (sunset)
- `429` — Too many requests - rate limit exceeded

---

[API](https://skmtc.net/fanvue/apis/fanvue-api.md) · [All operations](https://skmtc.net/fanvue/apis/fanvue-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fanvue/fanvue-api/revisions/c5ddcd5c7e72/schema)