List Referred Businesses
Lists the businesses the authenticated user referred onto Whop, most recent first.
Authorizations
An Account API key, account-scoped JWT, App API key, or user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************.
Headers
Pins the request to a dated API version.
"2026-09-15"
Query Parameters
Filter by referral status.
active, removed When true, only businesses with pending or completed earnings paid to the caller.
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.
The field to sort partner businesses by.
created_at, referral_started_at, referral_expires_at, payout_percentage, volume_usd, volume_30d_usd, earnings_usd Sort direction.
asc, desc Only return partner businesses created before this timestamp.
Only return partner businesses created after this timestamp.
Filter to referrals attributed to this user. For first-tier referrals, this is the referred account owner; for second-tier referrals, this is the partner you recruited.
Filter by the referred user's exact username. Ignored when referred_user_id is present.
Filter to referrals from a single tier: first, second, or blueprint.
first, second, blueprint Case-insensitive business-name prefix, or an exact biz_ account ID. Surrounding whitespace is ignored; blank values apply no filter.

