Skip to main content
GET
/
tracking-links
/
{uuid}
/
users
List users for a tracking link
curl --request GET \
  --url https://api.example.com/tracking-links/{uuid}/users \
  --header 'Authorization: Bearer <token>' \
  --header 'X-Fanvue-API-Version: <x-fanvue-api-version>'
{
  "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",
      "subscribedAt": "2024-01-15T00:00:00.000Z",
      "followedAt": null,
      "clickedAt": "2024-01-14T00: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",
      "subscribedAt": null,
      "followedAt": "2024-01-14T00:00:00.000Z",
      "clickedAt": "2024-01-14T00:00:00.000Z",
      "status": "follower"
    }
  ],
  "nextCursor": "456"
}
Required scope
  • read:tracking_links — Read tracking links and the users associated with them, including per-user tracking metadata.

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

uuid
string<uuid>
required

Tracking link UUID

Query Parameters

limit
integer

Number of results to return (default 20)

cursor
string

Cursor for pagination

Response

List of users associated with the tracking link

data
object[]
required

Users associated with this tracking link

nextCursor
string | null
required

Cursor for next page