Affiliates

Affiliate Stats

Aggregate stats for the shop's affiliate program, with 30-day deltas.

get/v1/shops/{shopId}/affiliates/stats

Response

total_affiliatesinteger
active_affiliatesinteger
inactive_affiliatesinteger
new_affiliatesinteger
new_affiliates_previousinteger
commissions_usdinteger
commissions_usd_previousinteger
commissions_usd_all_timeinteger
attributed_revenue_usdinteger
attributed_revenue_usd_previousinteger
attributed_revenue_usd_all_timeinteger
commissionable_revenue_usdinteger
commissionable_revenue_usd_previousinteger
commissionable_revenue_usd_all_timeinteger
attributed_ordersinteger
skipped_commissionsinteger
average_commission_rateinteger
top_earner_usdinteger
balance_modestring
pending_payout_requestsinteger
window_daysinteger

Example response

{
  "total_affiliates": 1,
  "active_affiliates": 0,
  "inactive_affiliates": 1,
  "new_affiliates": 1,
  "new_affiliates_previous": 0,
  "commissions_usd": 0,
  "commissions_usd_previous": 0,
  "commissions_usd_all_time": 0,
  "attributed_revenue_usd": 0,
  "attributed_revenue_usd_previous": 0,
  "attributed_revenue_usd_all_time": 0,
  "commissionable_revenue_usd": 0,
  "commissionable_revenue_usd_previous": 0,
  "commissionable_revenue_usd_all_time": 0,
  "attributed_orders": 0,
  "skipped_commissions": 0,
  "skipped_commissions_by_reason": [],
  "average_commission_rate": 0,
  "top_earner_usd": 0,
  "top_performers": [
    {
      "id": 1,
      "email": "customer@sellauth.test",
      "shop_id": 1,
      "balance": "0.00",
      "affiliate_balance": "0.00",
      "affiliate_code": "PARTNER10",
      "affiliate_code_set_at": "2026-08-28 18:23:02",
      "affiliate_tier_id": null,
      "affiliate_referrer_earnings": "0.00",
      "created_at": "2026-08-28T18:23:02.000000Z",
      "referrals_count": 0,
      "affiliate_tier": null
    }
  ],
  "balance_mode": "shared",
  "pending_payout_requests": 1,
  "window_days": 30
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.