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

## 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. Reflects the relationship matching the user's current status, and is null when there is no current relationship or when the relationship pre-dates the user's first click on this link (so it was not driven by it). For the raw relationship dates regardless of attribution, see subscribedAt / followedAt.
    - `subscribedAt` string, date-time, nullable, required — When the user subscribed to the creator, regardless of whether the subscription is attributed to this link. 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

---

[API](https://skmtc.net/fanvue/apis/fanvue-api.md) · [All operations](https://skmtc.net/fanvue/apis/fanvue-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fanvue/fanvue-api/revisions/c5ddcd5c7e72/schema)