Skip to main content
GET
/
notifications
Get notifications feed
curl --request GET \
  --url https://api.example.com/notifications \
  --header 'Authorization: Bearer <token>' \
  --header 'X-Fanvue-API-Version: <x-fanvue-api-version>'
{
  "data": [
    {
      "uuid": "6c3d8b1c-9b1f-4b6e-8d77-4e8b22ff9a01",
      "createdAt": "2026-05-22T08:30:00.000Z",
      "eventType": 11,
      "isRead": false,
      "data": {
        "price": 500
      },
      "originator": {
        "uuid": "8a3a93e2-1c2a-4b6c-b4fd-1cdaaa6fbc11",
        "handle": "sarahmiller",
        "displayName": "Sarah Miller",
        "avatarUrl": "https://media.fanvue.com/avatars/sarahmiller.jpg",
        "isCreator": false
      },
      "receiverUuid": "2bde24e6-942b-49d4-b7b9-8d1e8eccbffb"
    },
    {
      "uuid": "f1d2e3b4-aaaa-4f5b-9c1d-2c2dffe11a23",
      "createdAt": "2026-05-21T18:12:43.000Z",
      "eventType": 12,
      "isRead": true,
      "data": {},
      "originator": {
        "uuid": "21f5c1ab-7d22-4e7d-9c2b-e1c3a4f6bb22",
        "handle": "mikejohnson",
        "displayName": "Mike Johnson",
        "avatarUrl": null,
        "isCreator": false
      },
      "receiverUuid": "2bde24e6-942b-49d4-b7b9-8d1e8eccbffb"
    }
  ],
  "nextCursor": "eyJvZmZzZXQiOjIwfQ"
}
Required scope
  • read:self — Access your own user profile information, including basic account details and settings.

Authorizations

Authorization
string
header
required

OAuth 2.0 access token, presented as a JWT bearer token in the Authorization header. Obtain a token via the authorization-code flow; the scopes granted to the token determine which operations it may call.

Headers

X-Fanvue-API-Version
string
default:2025-06-26
required

API version to use for the request

Example:

"2025-06-26"

Query Parameters

limit
integer

Number of results to return (default 20)

Required range: x <= 100
cursor
string

Cursor for pagination

eventType
integer

Filter notifications by event type id

Response

List of notifications

data
object[]
required

Array of notifications

nextCursor
string | null
required

Cursor for the next page, or null if none