Skip to main content
GET
/
notifications
Get notifications feed
curl --request GET \
  --url https://api.fanvue.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"
    }
  ],
  "pagination": {
    "page": 1,
    "size": 2,
    "hasMore": true
  }
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

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

API version to use for the request

Example:

"2025-06-26"

Query Parameters

page
number
default:1

Page number to retrieve (starts from 1)

Required range: x >= 1
size
number
default:15

Number of items to return per page (1-50, default: 15)

Required range: 1 <= x <= 50
eventType
integer

Filter notifications by event type id

Response

List of notifications

data
object[]
required

Array of notifications

pagination
object
required

Pagination information