---
title: "List referred businesses"
method: GET
path: "/partners/businesses"
tags: ["Partners"]
---

# List referred businesses

`GET /partners/businesses`

Lists the businesses the authenticated user referred onto Whop, most recent first.

## Query parameters

- `status` 'active' | 'removed'
- `has_earnings` boolean
- `first` integer
- `after` string
- `last` integer
- `before` string
- `order` 'created_at' | 'referral_started_at' | 'referral_expires_at' | 'payout_percentage' | 'volume_usd' | 'earnings_usd'
- `direction` 'asc' | 'desc'
- `created_before` string
- `created_after` string
- `referred_user_id` string
- `referred_username` string
- `tier` 'first' | 'second' | 'blueprint'

## Response `200`

partner businesses listed

- object
  - `data` object[], required
    - `account` object, nullable, required — Referred account.
      - `id` string, required — Referred account ID.
      - `logo_url` string, nullable, required — Referred account logo URL.
      - `route` string, required — Referred account route.
      - `title` string, required — Referred account display name.
    - `blueprint_partner` object, nullable, required — The partner whose blueprint the business deployed. Null unless this is a blueprint referral.
      - `id` string, required — User ID, prefixed `user_`.
      - `name` string, nullable, required — The user's display name.
      - `profile_picture` object, required — The user's profile picture.
        - `url` string, required — The user's profile picture URL.
      - `username` string, required — The user's unique username.
    - `created_at` string, date-time, required — When the partner business was created.
    - `earnings_usd` object, required
      - `completed` string, required — Commission already paid out, in USD.
      - `pending` string, required — Commission scheduled but not yet paid, in USD.
      - `total` string, required — Pending + completed commission, in USD.
    - `first_tier_partner` object, nullable, required — The partner who referred the business owner onto Whop (first tier). Null if there is no active first-tier partner.
      - `id` string, required — User ID, prefixed `user_`.
      - `name` string, nullable, required — The user's display name.
      - `profile_picture` object, required — The user's profile picture.
        - `url` string, required — The user's profile picture URL.
      - `username` string, required — The user's unique username.
    - `id` string, required — Partner business ID.
    - `my_partner_tier` 'first' | 'second' | 'blueprint', required — Which tier the caller earns on for this business: `first` (they referred the owner), `second` (they referred the first-tier partner), or `blueprint` (the business deployed a site from their blueprint).
    - `object` 'partner_business', required
    - `owner` object, nullable, required — The owner of the referred business.
      - `email` string, nullable, required — The business owner's email address, so a partner can follow up on a referral they made. Requires the `partner:email:read` scope; `null` without it, or while the account has no reachable address of its own.
      - `id` string, required — User ID, prefixed `user_`.
      - `name` string, nullable, required — The user's display name.
      - `profile_picture` object, required — The user's profile picture.
        - `url` string, required — The user's profile picture URL.
      - `username` string, required — The user's unique username.
    - `payout_percentages` object, required — The referrer's commission rate for each income source, expressed as a fraction (0.3 = 30%).
      - `ad_spend` number, float, nullable, required — Share of the referred business's Whop Ads spend.
      - `card_interchange` number, float, nullable, required — Share of Whop's profit from card interchange.
      - `sales` number, float, required — Share of Whop's profit from product sales.
      - `transfer` number, float, nullable, required — Share of Whop's profit from platform balance transfers.
    - `referral_expires_at` string, date-time, nullable, required — When the referral expires.
    - `referral_started_at` string, date-time, nullable, required — When the referral became active.
    - `second_tier_partner` object, nullable, required — The second-tier partner who earns on this business (referred the first-tier partner). Null if there is no active second-tier partner.
      - `id` string, required — User ID, prefixed `user_`.
      - `name` string, nullable, required — The user's display name.
      - `profile_picture` object, required — The user's profile picture.
        - `url` string, required — The user's profile picture URL.
      - `username` string, required — The user's unique username.
    - `status` 'active' | 'removed', required — Current referral status.
    - `volume_usd` object, required
      - `attributed` string, required — Credited GMV (awaiting_settlement + settled); excludes canceled and reversed, in USD.
      - `awaiting_settlement` string, required — GMV awaiting settlement (commission not yet computed), in USD.
      - `settled` string, required — GMV of pending + completed payments, in USD.
  - `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

- `400` — Invalid Parameters
- `401` — Unauthorized
- `403` — Forbidden

## Changes

> 45 revisions in range; 1 not diffed.

- **2026-09-02** `9b2baa68698c` — 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-01** `8294de4a4e41` — 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-31** `4ddae15b5de8` — 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-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`

[Full history](https://skmtc.dev/whop/apis/whop-api/changes/partners/businesses/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/9b2baa68698c/schema)