Get subscriber by user UUID

Changed on

Returns a single subscriber of the authenticated user by their user UUID, including their subscription details. Returns 404 if the user is not a subscriber.

get/subscribers/{userUuid}

Request

  • Base URL
    https://api.fanvue.com
  • URL
    https://api.fanvue.com/subscribers/{userUuid}
  • Auth
    OAuth 2
    Authorization code: https://auth.fanvue.com/oauth2/auth
    Token URL: https://auth.fanvue.com/oauth2/token scopes: read:fan

Path parameters

userUuidstring uuid required

UUID of the subscriber to retrieve

Headers

X-Fanvue-API-Versionstring required
Example:2025-06-26

API version to use for the request

Response

Subscriber details

uuidstring uuid required
handlestring required
displayNamestring required
nicknamestring nullable required
isTopSpenderboolean required
avatarUrlstring nullable required
registeredAtstring date-time required
firstSubscribedAtstring date-time nullable 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.

Changes