Skip to main content
GET
/
creators
/
{creatorUserUuid}
/
tracking-links
/
{uuid}
/
users
/
{userUuid}
/
metadata
Get tracking metadata for a user on a creator's tracking link
curl --request GET \
  --url https://api.example.com/creators/{creatorUserUuid}/tracking-links/{uuid}/users/{userUuid}/metadata \
  --header 'Authorization: Bearer <token>' \
  --header 'X-Fanvue-API-Version: <x-fanvue-api-version>'
{
  "metadata": {
    "lead_id": "xyz123",
    "source": "snapchat",
    "conversation_id": "abc456"
  }
}
Required scopes
  • 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

​
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

​
creatorUserUuid
string<uuid>
required
​
uuid
string<uuid>
required

Tracking link UUID

​
userUuid
string<uuid>
required

User UUID

Response

User's tracking metadata

​
metadata
object
required

Custom metadata from the user's most recent impression on this link