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

- **2026-08-30** `9e320991dd2f` — 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-08-29** `1b5d50d09479` — 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-08-28** `4da7133b2de7` — 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-08-28** `85786e675f3b` — 3 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`
  - added the required property `data/items/user/email` to the response with the `200` status
- **2026-08-27** `16c82685be35` — 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-service-production.skmtc.workers.dev/v1/apis/whop/whop-api/revisions/9e320991dd2f/schema)