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

# List referred business earnings

`GET /partners/businesses/{id}/earnings`

Lists the earnings Whop pays out for one referred business's activity, most recent first.

## Query parameters

- `status` 'awaiting_settlement' | 'pending' | 'completed' | 'canceled' | 'reversed'
- `first` integer
- `after` string
- `last` integer
- `before` string
- `order` 'created_at' | 'commission_amount' | 'transaction_amount' | 'payout_at'
- `direction` 'asc' | 'desc'
- `created_before` string
- `created_after` string

## Response `200`

earnings 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.
    - `cancelation_reason` string, nullable, required — Why the earning was canceled or reversed, if applicable.
    - `commission_amount_usd` string, nullable, required — What the referrer earns, in USD. Null until the earning settles.
    - `created_at` string, date-time, required
    - `financial_activity` object[], nullable, required — Income and cost lines behind this earning's commission. Null for earnings settled before this data was recorded.
      - `amount` string, required — Line amount in its native currency.
      - `amount_usd` string, required — Line amount in USD.
      - `category` string, nullable, required — Fee or cost category of the line.
      - `created_at` string, date-time, nullable, required
      - `currency` string, required — Currency of the native amount.
      - `type` 'income' | 'expense', required — Whether the line is income Whop collected or a cost Whop paid.
    - `id` string, nullable, required
    - `income_source` 'sales' | 'ad_spend' | 'transfer' | 'card_interchange', required — Which income source the commission is on: product-sales gross profit, Whop Ads spend billed to the business, platform balance transfer fees, or Whop Card interchange.
    - `object` 'partner_business_earning', required
    - `payout_at` string, date-time, nullable, required
    - `payout_percentage` number, float, nullable, required — The referrer's share of Whop's gross profit, as a fraction (0.3 = 30%). Null until the earning settles.
    - `product` object, nullable, required
      - `id` string, required
      - `route` string, required
      - `title` string, required
    - `resource` union, required — The resource that generated the earning: the customer payment receipt for sales and ad spend earnings, the balance transfer for transfer earnings, or the card transaction for card interchange earnings.
      - object
        - `created_at` string, date-time, required
        - `currency` string, required
        - `id` string, required
        - `object` 'transfer', required
      - object
        - `created_at` string, date-time, required
        - `currency` string, nullable, required
        - `id` string, required
        - `merchant_name` string, nullable, required
        - `object` 'card_transaction', required
    - `second_tier` boolean, required — Whether this earning is a second-tier (grandparent) commission.
    - `status` 'awaiting_settlement' | 'pending' | 'completed' | 'canceled' | 'reversed', required — Current status of the earning.
    - `transaction_amount_usd` string, required — The underlying transaction amount the commission's income comes from, 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

---

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