Skip to main content
GET
/
creators
/
{creatorUserUuid}
/
subscribers
Get creator subscribers
curl --request GET \
  --url https://api.example.com/creators/{creatorUserUuid}/subscribers \
  --header 'Authorization: Bearer <token>' \
  --header 'X-Fanvue-API-Version: <x-fanvue-api-version>'
{
  "data": [
    {
      "uuid": "a1b2c3d4-5e6f-7g8h-9i0j-k1l2m3n4o5p6",
      "handle": "alex-fan",
      "nickname": "AlexF",
      "displayName": "Alex Fan",
      "isTopSpender": true,
      "avatarUrl": "https://media.fanvue.com/avatars/example-avatar.jpg",
      "registeredAt": "2024-01-10T12:00:00.000Z",
      "role": "creator"
    },
    {
      "uuid": "b2c3d4e5-6f7g-8h9i-0j1k-l2m3n4o5p6q7",
      "handle": "jordan-cool",
      "nickname": null,
      "displayName": "Jordan Cool",
      "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": true
  }
}
Required scopes
  • read:creator — Access creator profiles, content, and creator-specific information.
  • read:fan — Access fan-related data and information within the platform.

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"

Path Parameters

​
creatorUserUuid
string<uuid>
required

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

Response

List of creator subscribers

​
data
object[]
required

Array of subscribers

​
pagination
object
required

Pagination information