---
title: "List clicks on a creator's tracking link"
method: GET
path: "/creators/{creatorUserUuid}/tracking-links/{uuid}/impressions"
---

# List clicks on a creator's tracking link

`GET /creators/{creatorUserUuid}/tracking-links/{uuid}/impressions`

## Request

- Base URL: `https://api.fanvue.com`
- URL: `https://api.fanvue.com/creators/{creatorUserUuid}/tracking-links/{uuid}/impressions`
- Auth: OAuth 2
  - Authorization code: `https://auth.fanvue.com/oauth2/auth`
  - Token URL: `https://auth.fanvue.com/oauth2/token` scopes: `read:tracking_links`, `read:creator`

Every click on the link, newest first, with cursor-based pagination. Unlike the tracking-link users endpoint this includes clicks never matched to an account, which have a null `userUuid`, so a partner can reconcile click-level data without one request per fan.

Only allowlisted tracking parameters are returned in `metadata`; see the field description for the list.

Pass the previous response's `nextCursor` as `cursor` to fetch the next page; it is null on the last page. A cursor is only valid for the link it was issued for.

## Path parameters

- `creatorUserUuid` string, uuid, required
- `uuid` string, uuid, required: Tracking link UUID

## Query parameters

- `cursor` string: Opaque pagination cursor from a previous response's `nextCursor`
- `size` integer: Number of items to return (1-50, default: 15)

## Headers

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

## Response `200`

Clicks on the tracking link

- object
  - `data` object[], required: Clicks on the tracking link, newest first
    - `createdAt` string, date-time, required: When the link was clicked
    - `userUuid` string, uuid, nullable, required: The user the click was matched to, or null for a click never matched to an account (the visitor did not sign in or sign up afterwards). Anonymous clicks are expected.
    - `metadata` object, nullable, required: Tracking parameters captured from this click's landing URL. Only these query parameters are returned; any other parameter on the landing URL is omitted: `utm_campaign`, `utm_content`, `utm_medium`, `utm_source`, `utm_term`, `ref`, `click_id`, `clickid`, `clickId`, `fv_click_id`, `fvc_id` and `client_reference_id`. Null when none of them were present.
  - `nextCursor` string, nullable, required: Opaque cursor for the next page, or null when there are no more results
  - `total` number, nullable, required: Total number of items, or null when a count is not computed for this list

## 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

## Changes

- **2026-10-10** `79b9aba8a759`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/fanvue/apis/fanvue-api/changes/creators/:creatorUserUuid/tracking-links/:uuid/impressions/get.md)

---

[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/966260af2770?raw)