---
title: "List Smart Link Fans"
method: GET
path: "/api/smart-links/{smart_link_id}/fans"
tags: ["Smart Links"]
---

# List Smart Link Fans

`GET /api/smart-links/{smart_link_id}/fans`

Query attributed Smart Link fans with aggregate fan metrics and subscriber attribution metadata

## Query parameters

- `limit` integer — Rows per page. Default `100`
- `offset` integer — Offset for pagination. Default `0`
- `sort` 'revenue_net' | '-revenue_net' | 'tips_net' | '-tips_net' | 'messages_sent_by_fan' | '-messages_sent_by_fan' | 'converted_at' | '-converted_at' — Optional sort field. Default `-revenue_net`
- `has_messages` boolean — Optional - Filter to fans with or without fan-sent messages
- `min_messages_sent_by_fan` integer — Optional minimum number of messages sent by fan
- `min_revenue_net` number — Optional minimum net revenue
- `min_tips_net` number — Optional minimum net tips

## Response `200`

Success

- object
  - `data` object
    - `summary` object
      - `fans_total` integer
      - `revenue_net_total` integer
      - `tips_net_total` integer
      - `fans_with_3_plus_messages_total` integer
    - `rows` object[]
      - `fan_id` integer
      - `onlyfans_id` string
      - `username` string
      - `name` string
      - `avatar_url` string
      - `revenue_net` integer
      - `tips_net` integer
      - `messages_sent_by_fan` integer
      - `converted_at` string
      - `conversion_id` integer
      - `click_id` string
      - `external_click_id` string
    - `filters` object
      - `limit` integer
      - `offset` integer
      - `sort` string
      - `has_messages` string, nullable
      - `min_messages_sent_by_fan` string, nullable
      - `min_revenue_net` string, nullable
      - `min_tips_net` string, nullable
  - `_meta` object
    - `_credits` object
      - `used` integer
      - `balance` integer
      - `note` string
    - `_cache` object
      - `is_cached` boolean
      - `note` string

---

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