List the Users the Caller Referred
Lists the users the caller referred onto Whop, newest first by default, each with the caller’s total affiliate earnings from that user across all tiers. Earnings sorting uses cached totals. Authorized staff can set user_id=global to list referrals across partners, with earnings for each user’s current primary referrer.
Authorizations
A user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************. See Auth & API keys for how to get each one.
Headers
Pins the request to a dated API version.
"2026-09-29"
Query Parameters
Set to global to view referred users across partners with each primary referrer's cached total earnings. Requires an admin or partner manager session; OAuth tokens and company API keys cannot use global mode. Optionally narrow to one earning_partner_id or earning_partner_username.
global The selected referring partner's user_ ID. Requires user_id=global; cannot be combined with earning_partner_username.
The selected referring partner's exact username. Requires user_id=global; cannot be combined with earning_partner_id.
Search referred users by name or username. In global mode, matches the beginning of usernames only.
When true, only referred users who brought at least one business onto Whop.
When true, only referred users with at least one business that has generated earnings.
The field to sort by. created_at uses the user's signup date; earnings_usd uses the current primary referrer's cached total affiliate earnings from that user.
created_at, earnings_usd The direction to sort results.
asc, desc Number of results to return from the start of the range.
x <= 100Return results after this cursor. Use page_info.end_cursor from the previous response to fetch the next page.
Number of results to return from the end of the range.
x <= 100Return results before this cursor. Use page_info.start_cursor from the previous response to fetch the previous page.

