Skip to main content

Referrals

Use referral data when you want to show who is driving new buyers and how the monthly referral race is shaping up.

GET /api/public/v1/referrals 
curl "https://www.dyli.io/api/public/v1/referrals?limit=50" \
  -H "x-api-key: $DYLI_API_KEY"

The response includes the current month window, monthly leaderboard, all-time leaderboard, and tier config.

Query parameters:

NameDescription
limitNumber of leaderboard rows. Max 250. Alias: pageSize.

Leaderboard rows include rank, username, avatar, referral counts, qualified buyer counts when available, monthly GMV, points, and tier.