Fanvue API Documentation

curl https://api.fanvue.com/creators/creatorUserUuid/tracking-links/uuid/users \
     -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/fan-a.jpg",
      "registeredAt": "2024-01-15T00:00:00.000Z",
      "status": "subscriber"
    },
    {
      "uuid": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
      "handle": "mike-smith",
      "displayName": "Mike Smithly",
      "nickname": null,
      "isTopSpender": false,
      "avatarUrl": null,
      "registeredAt": "2024-01-14T00:00:00.000Z",
      "status": "follower"
    }
  ],
  "nextCursor": "456"
}

List users associated with a tracking link for the specified creator with cursor-based pagination.

Scope required: read:tracking_links read:creator

List users associated with a tracking link for the specified creator with cursor-based pagination. <Info>Scope required: `read:tracking_links` `read:creator`</Info>

Authentication

AuthorizationBearer

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

Path parameters

creatorUserUuidstringRequiredformat: "uuid"

uuidstringRequiredformat: "uuid"

Tracking link UUID

Query parameters

limitintegerOptional

Number of results to return (default 20)

cursorstringOptional

Cursor for pagination

Response

List of users associated with the tracking link

datalist of objects

Users associated with this tracking link

nextCursorstring or null

Cursor for next page

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

410

Gone Error

429

Too Many Requests Error

List users for a creator's tracking link