---
title: "Retrieve a referred business"
method: GET
path: "/partners/businesses/{id}"
tags: ["Partners"]
---

# Retrieve a referred business

`GET /partners/businesses/{id}`

Retrieves a single referred business and its referral terms.

## Response `200`

partner business retrieved

- object
  - `account` object, nullable, required — Referred account.
    - `capabilities` AccountCapabilities, required
      - `accept_bank_payments` 'active' | 'inactive' | 'pending', required — Bank payins: debits, transfers, and local bank rails
      - `accept_bnpl_payments` 'active' | 'inactive' | 'pending', required — Buy-now-pay-later payins; requires approval
      - `accept_card_payments` 'active' | 'inactive' | 'pending', required — Card payins, including Apple Pay and Google Pay
      - `bank_deposit` 'active' | 'inactive' | 'pending', required — Deposits by bank wire or ACH to the account's virtual bank account
      - `card_deposit` 'active' | 'inactive' | 'pending', required — Balance top-ups by charging a stored payment method
      - `card_issuing` 'active' | 'inactive' | 'pending', required — Issuing Whop cards; requires card application approval
      - `crypto_deposit` 'active' | 'inactive' | 'pending', required — On-chain deposits to the account's crypto wallet
      - `crypto_payout` 'active' | 'inactive' | 'pending', required — On-chain payouts to a crypto wallet
      - `instant_payout` 'active' | 'inactive' | 'pending', required — Instant payouts to an eligible payout destination
      - `run_ads` 'active' | 'inactive' | 'pending', required — Launching ad campaigns through Whop Ads. `inactive` while a requested ads services agreement is awaiting the account's signature.
      - `standard_payout` 'active' | 'inactive' | 'pending', required — Standard payouts to an external payout destination
      - `transfer` 'active' | 'inactive' | 'pending', required — Transfers to other accounts
    - `id` string, required — Referred account ID.
    - `logo_url` string, nullable, required — Referred account logo URL.
    - `recommended_actions` AccountRecommendedAction[], nullable, required — Optional actions that unlock capabilities or grow the referred account.
      - `action` 'theme_business' | 'create_product' | 'create_plan' | 'verify_identity' | 'connect_affiliate_program' | 'create_promotion' | 'setup_tracking_pixel' | 'migrate_from_stripe' | 'accept_first_payment' | 'launch_first_ad' | 'launch_draft_campaign' | 'increase_ad_budget' | 'refresh_ad_creatives' | 'fix_ad_billing' | 'exclude_customers_from_ads' | 'retarget_abandoned_checkouts' | 'invite_team_member' | 'enable_tax_collection' | 'create_card' | 'join_whop_university' | 'apply_for_financing', required — The recommendation; new values may be added, so handle unknown actions gracefully
      - `blocked_capabilities` string[], required
      - `cta` string, required — The URL the call-to-action links to
      - `cta_label` string, required — Button label
      - `description` string, required — Supporting copy, or empty
      - `icon_url` string, nullable, required — Illustration icon URL, or `null`
      - `impact_score` integer, nullable, required — Estimated impact from 0-100, or `null` when not ranked
      - `reasoning` string, nullable, required — Why this action was recommended, or `null`
      - `status` 'optional', required — Always optional — never blocking
      - `title` string, required — Headline for the recommendation
    - `required_actions` AccountRequiredAction[], nullable, required — Actions the referred account owner must take to unblock capabilities.
      - `action` 'deposit_funds' | 'submit_information_request' | 'verify_identity' | 'connect_fulfillment_tracker' | 'setup_apple_pay_domains' | 'configure_tax_remitter' | 'add_vat_registration', required — What the holder must do; new values may be added, so handle unknown actions gracefully
      - `blocked_capabilities` string[], required
      - `cta` string, nullable, required — The URL the call-to-action links to, or null when there is no button
      - `cta_label` string, required — Button label, or empty when there is no button
      - `description` string, required — Supporting copy, or empty
      - `icon_url` string, nullable, required — The URL of the action's illustration icon, or null if it has none
      - `status` 'required' | 'pending', required — required (act now) or pending (under review)
      - `title` string, required — Headline for the action
    - `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.

## Other responses

- `404` — Resource not found

---

[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/a8a43db4255f/schema)