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

# List users for a creator's tracking link

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

## Request

- Base URL: `https://api.fanvue.com`
- URL: `https://api.fanvue.com/creators/{creatorUserUuid}/tracking-links/{uuid}/users`
- 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`

List users associated with a tracking link for the specified creator with cursor-based pagination.

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

- `creatorUserUuid` string, uuid, required
- `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.
    - `creditedLinkUuid` string, uuid, nullable, required: The tracking link this user is credited to in the creator's link figures, which may be a different link from this one, or a deleted link that no longer appears in the tracking links list. Null when no click earns the credit. Under first-click attribution this is the first of the creator's links the user ever clicked; under period attribution it is the link credited with their most recent subscription period, or their most recent click if they have never subscribed.
    - `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)
    - `metadata` object, nullable, required: Tracking parameters from the user's most recent click on this link. As with the user-metadata endpoint this is the latest click only, so a later click with none of these parameters returns null. 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: 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-10-21** `966260af2770`: 1 info
  - added the required property `data/items/creditedLinkUuid` to the response with the `200` status
- **2026-10-10** `79b9aba8a759`: 1 info
  - added the required property `data/items/metadata` to the response with the `200` status
- **2026-08-30** `dce5621fe589`: 1 info
  - added the required property `data/items/currentSubscriptionStartedAt` to the response with the `200` status

[Operation history](https://skmtc.dev/fanvue/apis/fanvue-api/changes/creators/:creatorUserUuid/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/966260af2770?raw)