Leaderboard
Viewing the leaderboard
Section titled “Viewing the leaderboard”Go to Referrals in the sidebar. The leaderboard is displayed on the referrals page, showing your top referrers ranked by completed referrals.
Leaderboard columns
Section titled “Leaderboard columns”| Column | Description |
|---|---|
| Referrer | The user’s name and ID |
| Total | Total referrals created by this user |
| Completed | Referrals that reached the reward milestone |
| Pending | Currently active (not yet completed or expired) referrals |
| Total rewards | Sum of reward values earned from completed referrals |
The leaderboard is sorted by completed referrals (highest first). If two users have the same number of completed referrals, they are sorted by total referrals created.
Using the leaderboard
Section titled “Using the leaderboard”The leaderboard is useful for:
- Identifying top advocates: See which users are driving the most successful referrals.
- Reward fulfillment: Use the leaderboard data to verify reward claims before granting them in your system.
- Campaign analysis: Compare referral performance across time periods.
API access
Section titled “API access”The leaderboard is also available via the API:
GET /api/referral/leaderboard?limit=25Returns the top referrers (up to 100). Use this to display a leaderboard inside your app or on your website.