---
title: "Get Stats"
method: GET
path: "/affiliate/stats"
tags: ["affiliate"]
---

# Get Stats

`GET /affiliate/stats`

## Request

- Base URL: `https://api.framesail.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.framesail.com/affiliate/stats`
- Auth: HTTP bearer

## Response `200`

Successful Response

- AffiliateStats
  - `name` string, required
  - `promo_code` string, nullable
  - `pending_cents` integer, required
  - `approved_cents` integer, required
  - `paid_cents` integer, required
  - `lifetime_revenue_cents` integer, required
  - `qualified_referrals` integer, required
  - `signups` SignupStats: Accounts created through the affiliate's link (migration 0195). Visibility only: a signup earns nothing by itself. Commission comes from a subscription bought with the code applied at checkout (ToS 3.2).
    - `total` integer, required
    - `last_30_days` integer, required
    - `paying_customers` integer, required
  - `tier` integer, required
  - `rate_bps` integer, required
  - `min_payout_cents` integer, required
  - `terms_accepted` boolean, required
  - `progress` SchemasAffiliatePortalTierProgress, required: Progress toward the next tier — cumulative approved revenue only (TOS 3.1.1). The referral count is a stat on AffiliateStats, not a gate.
    - `next_tier` integer, nullable
    - `next_rate_bps` integer, nullable
    - `revenue_cents` integer, required
    - `revenue_target_cents` integer, nullable
  - `commissions` SchemasAffiliatePortalCommissionRow[], required
    - `id` string, required
    - `type` string, required
    - `status` string, required
    - `net_revenue_cents` integer, required
    - `rate_bps` integer, required
    - `commission_cents` integer, required
    - `reversed_cents` integer, required
    - `is_first_payment` boolean, required
    - `billing_reason` string, nullable
    - `created_at` string, required
    - `approved_at` string, nullable
    - `paid_at` string, nullable

---

[API](https://skmtc.dev/framesail/apis/framesail-api.md) · [All operations](https://skmtc.dev/framesail/apis/framesail-api/llms.txt) · [OpenAPI document](https://skmtc.dev/framesail/apis/framesail-api/revisions/12602eae0820?raw)
