OpenAPI 3.1.02026-08-203914245.9 MB
4a1a4a5d2c72
Partners
List referred business earnings
Lists the earnings Whop pays out for one referred business's activity, most recent first.
get/partners/businesses/{id}/earnings
Query parameters
status'awaiting_settlement' | 'pending' | 'completed' | 'canceled' | 'reversed'
Filter by earning status.
income_sourcestring[]
Filter to earnings from these income sources. Repeat the parameter for each one (income_source=sales&income_source=ad_spend).
[ "sales" ]
firstinteger
afterstring
lastinteger
beforestring
order'created_at' | 'commission_amount' | 'transaction_amount' | 'payout_at'
The field to sort earnings by.
direction'asc' | 'desc'
Sort direction.
created_beforestring
Only return earnings created before this timestamp.
created_afterstring
Only return earnings created after this timestamp.
Response
earnings listed
Example response
{
"data": [
{
"account": {
"id": "biz_xxxxxxxxxxxxxx",
"logo_url": "https://whop-assets-example.s3.amazonaws.com/uploads/image/2026-01-01/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"route": "biz_xxxxxxxxxxxxxx",
"title": "Gleam Mobile Detailing"
},
"cancelation_reason": "payment_refunded",
"commission_amount_usd": "1.00",
"created_at": "2026-01-01T12:00:00.000Z",
"financial_activity": [
{
"amount": "3.00",
"amount_usd": "3.00",
"category": "whop_processing_fee",
"created_at": "2026-01-01T12:00:00.000Z",
"currency": "usd",
"type": "income"
}
],
"id": "afpy_xxxxxxxxxxxxxx",
"income_source": "sales",
"object": "partner_business_earning",
"payout_at": "2026-01-01T12:00:00.000Z",
"payout_percentage": 0.04,
"product": {
"id": "prod_xxxxxxxxxxxxxx",
"route": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"title": "Ceramic Coating Package"
},
"resource": {
"created_at": "2026-01-01T12:00:00.000Z",
"currency": "usd",
"id": "pay_xxxxxxxxxxxxxx",
"object": "transfer"
},
"status": "pending",
"transaction_amount_usd": "10.00"
}
],
"page_info": {
"end_cursor": "WyJjdXJzb3IiLDFd",
"start_cursor": "WyJjdXJzb3IiLDFd"
}
}