List users for a tracking link
curl --request GET \
--url https://api.fanvue.com/v1/tracking-links/{uuid}/users \
--header 'Authorization: Bearer <token>' \
--header 'X-Fanvue-API-Version: <x-fanvue-api-version>'import requests
url = "https://api.fanvue.com/v1/tracking-links/{uuid}/users"
headers = {
"X-Fanvue-API-Version": "<x-fanvue-api-version>",
"Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {
'X-Fanvue-API-Version': '<x-fanvue-api-version>',
Authorization: 'Bearer <token>'
}
};
fetch('https://api.fanvue.com/v1/tracking-links/{uuid}/users', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"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": "2023-11-02T00:00:00.000Z",
"currentSubscriptionStartedAt": "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,
"currentSubscriptionStartedAt": null,
"followedAt": "2024-01-14T00:00:00.000Z",
"clickedAt": "2024-01-14T00:00:00.000Z",
"status": "follower"
}
],
"nextCursor": "456"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}{
"message": "<string>"
}{
"error": "<string>",
"message": "<string>",
"nextVersion": "<string>"
}{
"error": "<string>"
}Tracking links
List users for a tracking link
List users associated with a tracking link owned by the authenticated user.
Only clicks that could be matched to an account appear here, so this list is a subset of the link’s clicks count. A user who clicked without ever signing in cannot be identified and is omitted.
Users who clicked but never subscribed or followed are included, with status and the conversion dates set to null.
GET
/
v1
/
tracking-links
/
{uuid}
/
users
List users for a tracking link
curl --request GET \
--url https://api.fanvue.com/v1/tracking-links/{uuid}/users \
--header 'Authorization: Bearer <token>' \
--header 'X-Fanvue-API-Version: <x-fanvue-api-version>'import requests
url = "https://api.fanvue.com/v1/tracking-links/{uuid}/users"
headers = {
"X-Fanvue-API-Version": "<x-fanvue-api-version>",
"Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {
'X-Fanvue-API-Version': '<x-fanvue-api-version>',
Authorization: 'Bearer <token>'
}
};
fetch('https://api.fanvue.com/v1/tracking-links/{uuid}/users', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"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": "2023-11-02T00:00:00.000Z",
"currentSubscriptionStartedAt": "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,
"currentSubscriptionStartedAt": null,
"followedAt": "2024-01-14T00:00:00.000Z",
"clickedAt": "2024-01-14T00:00:00.000Z",
"status": "follower"
}
],
"nextCursor": "456"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}{
"message": "<string>"
}{
"error": "<string>",
"message": "<string>",
"nextVersion": "<string>"
}{
"error": "<string>"
}Required scope
read:tracking_links— Read tracking links and the users associated with them, including per-user tracking metadata.
Authorizations
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
API version to use for the request
Example:
"2025-06-26"
Path Parameters
Tracking link UUID
Query Parameters
Number of results to return (default 20)
Cursor for pagination
Was this page helpful?