Referrals

LearnWay rewards users with bonus XP and Gems for inviting friends to learn on the platform.

Generate / Get Referral Code

Endpoint

POST /api/v2/referral/code

Headers

Authorization: Bearer <jwt_access_token>

Response (201 Created)

{
  "referralCode": "CRYPTOSAGE2026"
}

Get Referral Statistics

Retrieves total invited users, completed onboarding milestones, and accumulated referral rewards.

Endpoint

GET /api/v2/referral/stats

Headers

Authorization: Bearer <jwt_access_token>

Response (200 OK)

{
  "success": true,
  "data": {
    "referralCode": "CRYPTOSAGE2026",
    "totalInvited": 12,
    "activeLearners": 8,
    "totalGemsEarned": 400,
    "totalXPEarned": 2500,
    "referrals": [
      {
        "username": "bob_web3",
        "joinedAt": "2026-08-15T09:00:00.000Z",
        "hasCompletedFirstCourse": true,
        "bonusClaimed": true
      }
    ]
  }
}