Sign in
OpenAPI 3.1.02026-08-143874115.7 MB

a84d4905fdbb

Partners

Retrieve a referred business

Retrieves a single referred business and its referral terms.

get/partners/businesses/{id}

Response

partner business retrieved

created_atstring date-time required

When the partner business was created.

idstring 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
referral_expires_atstring date-time nullable required

When the referral expires.

referral_started_atstring date-time nullable required

When the referral became active.

status'active' | 'removed' required

Current referral status.

Example response

{
  "account": {
    "capabilities": {
      "accept_bank_payments": "active",
      "accept_bnpl_payments": "inactive",
      "accept_card_payments": "active",
      "bank_deposit": "inactive",
      "card_deposit": "active",
      "card_issuing": "inactive",
      "crypto_deposit": "active",
      "crypto_payout": "inactive",
      "instant_payout": "inactive",
      "run_ads": "active",
      "standard_payout": "inactive",
      "transfer": "inactive"
    },
    "id": "biz_xxxxxxxxxxxxxx",
    "logo_url": "https://assets-2-rough.whop.com/uploads/image/2026-01-01/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "recommended_actions": [
      {
        "action": "apply_for_financing",
        "blocked_capabilities": [
          "accept_bnpl_payments"
        ],
        "cta": "https://whop.com/dashboard/biz_xxxxxxxxxxxxxx/settings/payments/",
        "cta_label": "Apply",
        "description": "Let customers pay over time with buy now, pay later.",
        "icon_url": "https://whop.com/illustrations/orange/piggy-bank.svg",
        "impact_score": 86,
        "reasoning": "Financing lifts conversion on the $249 ceramic coating, the priciest job on the menu.",
        "status": "optional",
        "title": "Offer financing at checkout"
      }
    ],
    "required_actions": [
      {
        "action": "verify_identity",
        "blocked_capabilities": [
          "standard_payout"
        ],
        "cta": "https://whop.com/dashboard/biz_xxxxxxxxxxxxxx/balance/",
        "cta_label": "Verify now",
        "description": "Complete verification to withdraw your earnings.",
        "icon_url": "https://whop.com/illustrations/orange/shield.svg",
        "status": "required",
        "title": "Complete your identity verification"
      }
    ],
    "route": "biz_xxxxxxxxxxxxxx",
    "title": "Gleam Mobile Detailing"
  },
  "created_at": "2026-01-01T12:00:00.000Z",
  "earnings_usd": {
    "completed": "0.00",
    "pending": "0.00",
    "total": "0.00"
  },
  "first_tier_partner": {
    "id": "user_xxxxxxxxxxxxxx",
    "name": "Tanya Cole",
    "profile_picture": {
      "url": "https://ui-avatars.com/api/"
    },
    "username": "tanyacole"
  },
  "id": "coma_xxxxxxxxxxxxxx",
  "my_partner_tier": "second",
  "object": "partner_business",
  "owner": {
    "id": "user_xxxxxxxxxxxxxx",
    "name": "Nina Alvarez",
    "profile_picture": {
      "url": "https://ui-avatars.com/api/"
    },
    "username": "ninaalvarez"
  },
  "payout_percentages": {
    "ad_spend": 0.015,
    "card_interchange": 0.2,
    "sales": 0.1,
    "transfer": 0.25
  },
  "referral_expires_at": "2026-01-01T12:00:00.000Z",
  "referral_started_at": "2026-01-01T12:00:00.000Z",
  "second_tier_partner": {
    "id": "user_xxxxxxxxxxxxxx",
    "name": "Marcus Webb",
    "profile_picture": {
      "url": "https://ui-avatars.com/api/"
    },
    "username": "marcuswebb"
  },
  "status": "active",
  "volume_usd": {
    "attributed": "0.00",
    "awaiting_settlement": "0.00",
    "settled": "0.00"
  }
}