---
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'
- `income_source` string[]
- `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' | 'onboarding_reward' | 'partner_reward', required — Which income source the commission is on: product-sales gross profit, Whop Ads spend billed to the business, platform balance transfer fees, Whop Card interchange, or a fixed onboarding or referral link reward paid to the partner when a referred business qualifies.
    - `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, the card transaction for card interchange earnings, or the qualifying reward for fixed reward 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
      - object
        - `business_id` string, required — The referred business that qualified.
        - `created_at` string, date-time, required
        - `id` string, nullable, required — The retired onboarding reward ID. Always null; retained for historical earnings compatibility.
        - `object` 'onboarding_reward', required
        - `slug` string, nullable, required — The retired reward link slug. Always null; retained for historical earnings compatibility.
      - object
        - `business_id` string, required — The referred business that qualified.
        - `created_at` string, date-time, required
        - `id` string, required — The referral link reward the business qualified for, prefixed `prwd_`.
        - `object` 'partner_reward', 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

## Changes

> 71 revisions in range; 1 not diffed.

- **2026-09-21** `ac2b9b1c6a00` — 1 warning, 2 info
  - added the new `partner_reward` enum value to the `data/items/income_source` response property for the response status `200`
  - added the enum value `partner_reward` to the property `items/` of the `query` request parameter `income_source`
  - added `subschema #5` to the `data/items/resource` response property `anyOf` list for the response status `200`
- **2026-09-13** `2d59d2cf94cf` — 1 warning, 2 info
  - added the new `onboarding_reward` enum value to the `data/items/income_source` response property for the response status `200`
  - added the enum value `onboarding_reward` to the property `items/` of the `query` request parameter `income_source`
  - added `subschema #4` to the `data/items/resource` response property `anyOf` list for the response status `200`
- **2026-08-20** `4a1a4a5d2c72` — 1 info
  - added the new optional `query` request parameter `income_source`
- **2026-08-14** `a84d4905fdbb` — 2 info
  - added `subschema #1, subschema #2, subschema #3` to the `data/items/resource` response property `anyOf` list for the response status `200`
  - removed `subschema #1, subschema #2, subschema #3` from the `data/items/resource` response property `anyOf` list for the response status `200`
- **2026-08-07** `f1020c3ecda4` — 1 info
  - added the optional property `error/code` to the response with the `400` status

[Full history](https://skmtc.dev/whop/apis/whop-api/changes/partners/businesses/:id/earnings/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.dev/whop/apis/whop-api/revisions/c1dceb26e505?raw)