Skip to main content
GET
Get tracking metadata for a user on a creator's tracking link
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 | null
required

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.