---
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', 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 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, 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
      - object
        - `business_id` string, required — The referred business that qualified.
        - `created_at` string, date-time, required
        - `id` string, nullable, required — The onboarding reward the referred business qualified for, prefixed `onbr_`.
        - `object` 'onboarding_reward', required
        - `slug` string, nullable, required — The reward link slug.
    - `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

> 61 revisions in range; 1 not diffed.

- **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
- **2026-07-26** `60bbb4a6ffbc` — 2 info
  - added `subschema #2, subschema #3` to the `data/items/resource` response property `anyOf` list for the response status `200`
  - added the required property `data/items/income_source` to the response with the `200` 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/ef86d14ef691?raw)