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

## 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.
    - `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', required — Which tier the caller earns on for this business: `first` (they referred the owner) or `second` (they referred the first-tier partner).
    - `object` 'partner_business', required
    - `owner` object, nullable, required — The owner of the referred business.
      - `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

---

[API](https://skmtc.net/whop/apis/whop-api.md) · [All operations](https://skmtc.net/whop/apis/whop-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/whop/whop-api/versions/866821546d67/schema)