curl --request GET \
--url https://api.fanvue.com/v1/creators/{creatorUserUuid}/tracking-links/{uuid}/users/{userUuid}/metadata \
--header 'Authorization: Bearer <token>' \
--header 'X-Fanvue-API-Version: <x-fanvue-api-version>'import requests
url = "https://api.fanvue.com/v1/creators/{creatorUserUuid}/tracking-links/{uuid}/users/{userUuid}/metadata"
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/creators/{creatorUserUuid}/tracking-links/{uuid}/users/{userUuid}/metadata', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"metadata": {
"lead_id": "xyz123",
"source": "snapchat",
"conversation_id": "abc456"
}
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}{
"message": "<string>"
}{
"error": "<string>",
"message": "<string>",
"nextVersion": "<string>"
}{
"error": "<string>"
}Get tracking metadata for a user on a creator's tracking link
Get the custom tracking metadata from a user’s most recent impression on a tracking link for the specified creator.
Metadata is captured from the query string of the shared short link (https://www.fanvue.com/<handle>/fv-3?campaign=spring_launch), using plain query parameters rather than the metadata[<key>] syntax checkout links use. Every non-reserved parameter is captured as-is, trimmed to 10 keys and 500 characters per value; over-limit input is silently trimmed rather than rejected.
Only the most recent impression is returned, and metadata is never merged across clicks: a later click replaces the previous values wholesale, and a later click with no query parameters returns null.
Returns 404 when the link is not one of the creator’s, and 200 with metadata: null when the user has no attributed impression carrying usable metadata.
See the tracking links guide for the full mechanism, limits and worked examples.
curl --request GET \
--url https://api.fanvue.com/v1/creators/{creatorUserUuid}/tracking-links/{uuid}/users/{userUuid}/metadata \
--header 'Authorization: Bearer <token>' \
--header 'X-Fanvue-API-Version: <x-fanvue-api-version>'import requests
url = "https://api.fanvue.com/v1/creators/{creatorUserUuid}/tracking-links/{uuid}/users/{userUuid}/metadata"
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/creators/{creatorUserUuid}/tracking-links/{uuid}/users/{userUuid}/metadata', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"metadata": {
"lead_id": "xyz123",
"source": "snapchat",
"conversation_id": "abc456"
}
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}{
"message": "<string>"
}{
"error": "<string>",
"message": "<string>",
"nextVersion": "<string>"
}{
"error": "<string>"
}read:tracking_links— Read tracking links and the users associated with them, including per-user tracking metadata.read:creator— Access creator profiles, content, and creator-specific information.
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
"2025-06-26"
Path Parameters
Tracking link UUID
User UUID
Response
User's tracking metadata
Custom metadata from the user's most recent impression on this link, captured from the query string of the shared short link. Null when the user has no attributed impression carrying usable metadata, including when their latest click carried no query parameters.
Show child attributes
Show child attributes
Was this page helpful?