Docs/Call of Duty API/Leaderboards
Back to Call of Duty API

Leaderboards

Access player rankings by earnings and performance stats

Earnings Leaderboard

GET/cod/leaderboards/earnings

Get top earners in COD esports history or filtered by season.

Query Parameters

ParameterTypeDescription
seasonstringFilter by season
limitnumberNumber of players (default: 50)

Example Request

GET /api/v1/cod/leaderboards/earnings?limit=10

Response

{
  "success": true,
  "data": [
    {
      "rank": 1,
      "player": {
        "codPlayerId": "...",
        "ign": "Scump",
        "team": "OpTic Texas",
        "imageUrl": "https://..."
      },
      "totalEarnings": 3500000,
      "tournamentsWon": 32
    },
    {
      "rank": 2,
      "player": {
        "codPlayerId": "...",
        "ign": "Crimsix",
        "team": null,
        "imageUrl": "https://..."
      },
      "totalEarnings": 3200000,
      "tournamentsWon": 37
    }
  ]
}

Stats Leaderboard by Mode

GET/cod/leaderboards/:mode

Get top performers by game mode stats. Available modes: hardpoint, snd, control, overall.

Query Parameters

ParameterTypeDescription
statstringStat to rank by (kills, kd, damage, hillTime, firstBloods)
seasonstringFilter by season
limitnumberNumber of players (default: 25)

Example Request

GET /api/v1/cod/leaderboards/hardpoint?stat=damage&limit=25

Response

{
  "success": true,
  "mode": "hardpoint",
  "stat": "damage",
  "season": "2025",
  "data": [
    {
      "rank": 1,
      "player": {
        "ign": "Cellium",
        "team": "Atlanta FaZe"
      },
      "value": 4250,
      "mapsPlayed": 45
    },
    {
      "rank": 2,
      "player": {
        "ign": "Dashy",
        "team": "OpTic Texas"
      },
      "value": 4180,
      "mapsPlayed": 42
    }
  ]
}