# 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](/types/#scalars) `Int!` | Every business that signed up with your code — gone ones included. |
| `pendingCount` | [Int](/types/#scalars) `Int!` | No further notes. |
| `approvedCount` | [Int](/types/#scalars) `Int!` | No further notes. |
| `deniedCount` | [Int](/types/#scalars) `Int!` | No further notes. |
| `goneCount` | [Int](/types/#scalars) `Int!` | Referred businesses that no longer exist on the platform (their rows read blank — no code, no standing). |
| `earningCount` | [Int](/types/#scalars) `Int!` | Referred businesses with at least one earning entry (accrue or usage). |
| `earnedUsdCents` | [Int](/types/#scalars) `Int!` | Lifetime Σ accrue + usage (USD cents, ≥ 0). |
| `appliedUsdCents` | [Int](/types/#scalars) `Int!` | Lifetime Σ applied — your own base fees credit-settled from earnings (USD cents, ≤ 0). |
| `clawbackUsdCents` | [Int](/types/#scalars) `Int!` | Lifetime Σ clawback — dispute reversals (USD cents, ≤ 0). |
| `spendableUsdCents` | [Int](/types/#scalars) | Your wallet's spendable referral credit (USD cents). Null when the group holds no wallet. |
| `months` | [ReferralMonth](/types/ReferralMonth/) `[ReferralMonth!]!` | The NEWEST 12 months that carry entries, NEWEST-first. |
| `referrals` | [ReferralPerformance](/types/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). |

## Used by

- [referralReport](/reference/billing-and-the-wallet/referralReport/)