Players

Access CDL player profiles, stats, earnings, and match history

List All Players

GET/cod/players

Get a list of all professional COD players. Filter by team, region, or search by name.

Query Parameters

Parameter	Type	Description
`team`	string	Filter by team slug
`region`	string	Filter by region
`activeOnly`	boolean	Only active players
`search`	string	Search by name/IGN
`limit`	number	Results per page (default: 50)
`offset`	number	Pagination offset

Example Request

GET /api/v1/cod/players?team=optic-texas&activeOnly=true

Get Player Details

GET/cod/players/:id

Get detailed info about a player including career history, earnings, and current team. The :id can be player ID, IGN (case-insensitive), or Activision ID.

Example Request

GET /api/v1/cod/players/simp

Response

{
  "success": true,
  "data": {
    "codPlayerId": "...",
    "ign": "Simp",
    "realName": "Chris Lehr",
    "nationality": "US",
    "country": "United States",
    "birthDate": "2002-01-10",
    "imageUrl": "https://...",
    "currentTeam": {
      "slug": "atlanta-faze",
      "name": "Atlanta FaZe",
      "role": "Player"
    },
    "totalEarnings": 1500000,
    "rosterHistory": [...],
    "recentTransfers": [...]
  }
}

Get Player Earnings

GET/cod/players/:id/earnings

Get tournament earnings history for a player, broken down by event.

Query Parameters

Parameter	Type	Description
`limit`	number	Results per page
`offset`	number	Pagination offset

Response

{
  "success": true,
  "data": {
    "player": "Simp",
    "totalEarnings": 1500000,
    "earnings": [
      {
        "tournament": "CDL Championship 2024",
        "placement": "1st",
        "amount": 250000,
        "date": "2024-08-15"
      }
    ]
  }
}

Get Player Upcoming Matches

GET/cod/players/:id/upcoming-matches

Get scheduled matches for a player's current team.

Get Player Stats

GET/cod/players/:id/stats

Get in-game performance stats including K/D, damage, kills per 10 minutes, and mode-specific stats.

Query Parameters

Parameter	Type	Description
`season`	string	Filter by season
`mode`	string	Filter by game mode (Hardpoint, SnD, Control)
`tournamentId`	string	Filter by tournament

Example Request

GET /api/v1/cod/players/shotzzy/stats?season=2025

Response

{
  "success": true,
  "data": {
    "player": {
      "ign": "Shotzzy",
      "team": "OpTic Texas"
    },
    "season": "2025",
    "overall": {
      "kd": 1.18,
      "killsPer10": 24.5,
      "deathsPer10": 20.8,
      "damagePer10": 3847,
      "matchesPlayed": 48
    },
    "byMode": {
      "hardpoint": {
        "kd": 1.15,
        "killsPer10": 26.2,
        "hillTime": "2:34",
        "engagements": 32.1
      },
      "searchAndDestroy": {
        "kd": 1.24,
        "killsPerRound": 0.82,
        "firstBloods": 0.18,
        "plants": 0.12
      },
      "control": {
        "kd": 1.21,
        "killsPer10": 22.8,
        "captures": 2.4,
        "defends": 3.1
      }
    }
  }
}

Get Player Matches

GET/cod/players/:id/matches

Get match history with per-match stats for a player.

Query Parameters

Parameter	Type	Description
`limit`	number	Results per page
`offset`	number	Pagination offset

Response

{
  "success": true,
  "data": [
    {
      "matchId": "12345",
      "date": "2025-01-28T18:00:00Z",
      "tournament": "CDL Major 1",
      "opponent": "Atlanta FaZe",
      "result": "W",
      "score": "3-1",
      "playerStats": {
        "kills": 85,
        "deaths": 72,
        "kd": 1.18,
        "damage": 15420
      }
    }
  ]
}

Organizations

Tournaments