---
title: "Get tracking metadata for a user"
method: GET
path: "/tracking-links/{uuid}/users/{userUuid}/metadata"
---

# Get tracking metadata for a user

`GET /tracking-links/{uuid}/users/{userUuid}/metadata`

Get the custom tracking metadata from a user's most recent impression on a tracking link.

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](https://api.fanvue.com/docs/tutorials/tracking-links) for the full mechanism, limits and worked examples.

## Path parameters

- `uuid` string, uuid, required — Tracking link UUID
- `userUuid` string, uuid, required — User UUID

## Headers

- `X-Fanvue-API-Version` string, required

## Response `200`

User's tracking metadata

- object
  - `metadata` object, nullable, 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.

## Other responses

- `400` — Bad Request - API version not supported OR validation failed OR invalid UUID
- `401` — Unauthorized Response
- `403` — Unauthorized Response
- `404` — Not Found Response
- `410` — API version no longer supported (sunset)
- `429` — Too many requests - rate limit exceeded

---

[API](https://skmtc.dev/fanvue/apis/fanvue-api.md) · [All operations](https://skmtc.dev/fanvue/apis/fanvue-api/llms.txt) · [OpenAPI document](https://skmtc.dev/fanvue/apis/fanvue-api/revisions/431868e8a264?raw)