---
title: "List the users the caller referred"
method: GET
path: "/partners/referred_users"
tags: ["Partners"]
---

# List the users the caller referred

`GET /partners/referred_users`

Lists the users the caller referred onto Whop (newest first), each with the second-tier earnings the caller has made from that user's businesses.

## Query parameters

- `has_businesses` boolean
- `has_earning_businesses` boolean
- `first` integer
- `after` string
- `last` integer
- `before` string

## Response `200`

referred users listed

- object
  - `data` object[], required
    - `total_earnings_usd` string, required
    - `total_volume_usd` string, required
    - `user` object, required
      - `city` string, nullable
      - `country` string, nullable
      - `email` string, nullable, required — The referred user's email address, so a partner can follow up with someone they brought onto Whop. Requires the `partner:email:read` scope; `null` without it, or while the account has no reachable address of its own.
      - `id` string, required
      - `name` string, nullable
      - `profile_picture` object
        - `url` string, nullable
      - `username` string, required
  - `page_info` object, required
    - `end_cursor` string, nullable, required
    - `has_next_page` boolean, required
    - `has_previous_page` boolean, required
    - `start_cursor` string, nullable, required

## Other responses

- `401` — Unauthorized

## Changes

> 69 revisions in range; 1 not diffed.

- **2026-09-23** `140d015b9966` — 2 info
  - the security scope `partner:basic:read` was added to the endpoint's security scheme `bearerAuth`
  - the security scope `referral:basic:read` was removed from the endpoint's security scheme `bearerAuth`
- **2026-09-22** `35edb053220a` — 2 info
  - the security scope `partner:basic:read` was added to the endpoint's security scheme `bearerAuth`
  - the security scope `referral:basic:read` was removed from the endpoint's security scheme `bearerAuth`
- **2026-09-21** `ac2b9b1c6a00` — 2 info
  - the security scope `partner:basic:read` was added to the endpoint's security scheme `bearerAuth`
  - the security scope `referral:basic:read` was removed from the endpoint's security scheme `bearerAuth`
- **2026-09-21** `a88353507eac` — 2 info
  - the security scope `partner:basic:read` was added to the endpoint's security scheme `bearerAuth`
  - the security scope `referral:basic:read` was removed from the endpoint's security scheme `bearerAuth`
- **2026-09-20** `51933d70d7f5` — 2 info
  - the security scope `partner:basic:read` was added to the endpoint's security scheme `bearerAuth`
  - the security scope `referral:basic:read` was removed from the endpoint's security scheme `bearerAuth`

[Full history](https://skmtc.dev/whop/apis/whop-api/changes/partners/referred_users/get.md)

---

[API](https://skmtc.dev/whop/apis/whop-api.md) · [All operations](https://skmtc.dev/whop/apis/whop-api/llms.txt) · [OpenAPI document](https://skmtc.dev/whop/apis/whop-api/revisions/140d015b9966?raw)