---
title: "List users for a tracking link"
method: GET
path: "/tracking-links/{uuid}/users"
---

# List users for a tracking link

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

List users associated with a tracking link owned by the authenticated user.

Only clicks that could be matched to an account appear here, so this list is a subset of the link's `clicks` count. A user who clicked without ever signing in cannot be identified and is omitted.

Users who clicked but never subscribed or followed are included, with `status` and the conversion dates set to null.

## Path parameters

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

## Query parameters

- `limit` integer — Number of results to return (default 20)
- `cursor` string — Cursor for pagination

## Headers

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

## Response `200`

List of users associated with the tracking link

- object
  - `data` object[], required — Users associated with this tracking link
    - `uuid` string, uuid, required
    - `handle` string, required
    - `displayName` string, required
    - `nickname` string, nullable, required
    - `isTopSpender` boolean, required
    - `avatarUrl` string, nullable, required
    - `registeredAt` string, date-time, nullable, required — When the user converted (subscribed to or followed the creator) via this tracking link — the conversion attributed to the link. Despite the name this is not the account-creation date. Reflects the relationship matching the user's current status, and is null when there is no current relationship or when the conversion pre-dates the user's first click on this link (so it was not driven by it). For subscribers the conversion is the start of the subscription currently on file, so a fan who lapsed and resubscribed through this link is attributed to it. For the raw relationship dates regardless of attribution, see subscribedAt / followedAt.
    - `subscribedAt` string, date-time, nullable, required — When the user first subscribed to the creator, regardless of whether the subscription is attributed to this link. Does not advance when a lapsed fan resubscribes — see currentSubscriptionStartedAt for the start of the subscription currently on file. Null if the user has no subscription to the creator.
    - `currentSubscriptionStartedAt` string, date-time, nullable, required — When the subscription currently on file began: the most recent resubscribe, or the same value as subscribedAt when the fan never lapsed. Unaffected by renewals. Null if the user has no subscription to the creator.
    - `followedAt` string, date-time, nullable, required — When the user followed the creator, regardless of whether the follow is attributed to this link. Null if the user does not follow the creator.
    - `clickedAt` string, date-time, nullable, required — When the user first clicked this tracking link.
    - `status` 'subscriber' | 'follower' | 'expired' | 'deleted', nullable, required — User's relationship status with the creator: subscriber (active subscription), follower (following only), expired (subscription ended), deleted (user soft-deleted), or null (registered via link but no current relationship)
  - `nextCursor` string, nullable, required — Cursor for next page

## 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-08-30** `dce5621fe589` — 1 info
  - added the required property `data/items/currentSubscriptionStartedAt` to the response with the `200` status

[Change history](https://skmtc.dev/fanvue/apis/fanvue-api/changes/tracking-links/:uuid/users/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/431868e8a264?raw)