Affiliates
Get Affiliate Leaderboard
Public, unauthenticated endpoint. Top 50 affiliates ranked by commission earnings, for the current calendar month or all-time.
Query Parameters
period?string
Default
"monthly"Value in
- "monthly"
- "all_time"
Response Body
application/json
application/json
curl -X GET "https://example.com/api/v1/affiliates/leaderboard"{ "success": true, "message": "string", "data": [ { "rank": 0, "earningsCents": 0, "commissions": 0, "user": { "id": "string", "name": "string", "username": "string", "image": "string", "affiliateTier": "TIER_1" } } ]}Track Affiliate ClickPOST
Public, unauthenticated endpoint. Records a click against an affiliate's referral code. Entire affiliate program is gated behind a feature flag (`config.growth.affiliateProgramEnabled`) that defaults off in production until explicitly enabled — every route in this group, including this one, returns `503` while the flag is off.
Get My Affiliate DashboardGET
Returns the caller's affiliate status, tier, wallet, clicks, referrals, commissions, and withdrawal history. Session-authenticated only.