ReferralReport
object type
Your referral program at a glance: counts by standing, lifetime totals by kind (SIGNED like the ledger: earned ≥ 0 · applied/clawback ≤ 0), the spendable credit, the NEWEST 12 months that carry entries, and one page of referred businesses with their figures.
Fields
| Field | Type | Notes |
|---|---|---|
referredCount | Int Int! | Every business that signed up with your code — gone ones included. |
pendingCount | Int Int! | No further notes. |
approvedCount | Int Int! | No further notes. |
deniedCount | Int Int! | No further notes. |
goneCount | Int Int! | Referred businesses that no longer exist on the platform (their rows read blank — no code, no standing). |
earningCount | Int Int! | Referred businesses with at least one earning entry (accrue or usage). |
earnedUsdCents | Int Int! | Lifetime Σ accrue + usage (USD cents, ≥ 0). |
appliedUsdCents | Int Int! | Lifetime Σ applied — your own base fees credit-settled from earnings (USD cents, ≤ 0). |
clawbackUsdCents | Int Int! | Lifetime Σ clawback — dispute reversals (USD cents, ≤ 0). |
spendableUsdCents | Int | Your wallet's spendable referral credit (USD cents). Null when the group holds no wallet. |
months | ReferralMonth [ReferralMonth!]! | The NEWEST 12 months that carry entries, NEWEST-first. |
referrals | ReferralPerformance [ReferralPerformance!]! | One page of your referred businesses, NEWEST-first by the referred group's id (limit clamps [1,200] default 50; before = a strict id upper bound — the affiliateAccruals grammar). |