Skip to main content
GET
Get subscriber by user UUID
Required scope
  • 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

userUuid
string<uuid>
required

UUID of the subscriber to retrieve

Response

Subscriber details

uuid
string<uuid>
required
handle
string
required
displayName
string
required
nickname
string | null
required
isTopSpender
boolean
required
avatarUrl
string | null
required
registeredAt
string<date-time>
required
subscription
object | null
required

Details of the subscriber's current subscription to the creator, or null if none is found

firstSubscribedAt
string<date-time> | null
required

When the fan first subscribed to the creator (earliest across their whole subscription history), used to tell a genuinely new fan from a re-subscriber. Null if unknown.