Fanvue API Documentation

curl https://api.fanvue.com/subscribers \
     -H "X-Fanvue-API-Version: 2025-06-26" \
     -H "Authorization: Bearer <token>"

{
  "data": [
    {
      "uuid": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "handle": "sarah-jones",
      "displayName": "Sarah Jones",
      "nickname": "SarahK",
      "isTopSpender": true,
      "avatarUrl": "https://media.fanvue.com/avatars/example-avatar.jpg",
      "registeredAt": "2024-01-10T12:00:00.000Z",
      "role": "creator"
    },
    {
      "uuid": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
      "handle": "mike-smith",
      "displayName": "Mike Smithly",
      "nickname": null,
      "isTopSpender": false,
      "avatarUrl": "https://media.fanvue.com/avatars/example-avatar.jpg",
      "registeredAt": "2024-01-10T12:00:00.000Z",
      "role": "creator"
    }
  ],
  "pagination": {
    "page": 1,
    "size": 2,
    "hasMore": false
  }
}

Returns a paginated list of users who have subscriptions to the authenticated user.

Scope required: read:fan

Returns a paginated list of users who have subscriptions to the authenticated user. <Info>Scope required: `read:fan`</Info>

Authentication

AuthorizationBearer

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

Query parameters

pagedoubleOptional>=1Defaults to 1

Page number to retrieve (starts from 1)

sizedoubleOptional1-50Defaults to 15

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

sortFieldenumOptional

Public field to sort by

Allowed values:

sortDirectionenumOptional

Sort direction

Allowed values:

Response

List of subscribers

datalist of objects

Array of subscribers

paginationobject

Pagination information

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

410

Gone Error

429

Too Many Requests Error

Get subscribers

Authentication

Headers

Query parameters

Response

Errors