Prefer to chat? Query the API with natural language using our AI Skill →

Give your AI tool live Cito endpoint context before you write integration code.

Open AI Skill

Public docs assistant

Tell Cito API what you are building.

Get endpoint recommendations, exact requests, code snippets, and a free-key CTA without digging through every page.

Docs/Call of Duty API/Players

Back to Call of Duty API

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 Transfers

GET/cod/players/:id/transfers

Get a player's roster movement history with source team, destination team, role, and transfer date.

Query Parameters

Parameter	Type	Description
`limit`	number	Results per page (default: 20)
`offset`	number	Pagination offset

Example Request

GET /api/v1/cod/players/bance/transfers?limit=10

Response

{
  "success": true,
  "data": {
    "player": {
      "ign": "Bance",
      "realName": "Ben Bance"
    },
    "transfers": [
      {
        "transferType": "signed",
        "fromTeam": {
          "slug": "omit-noir",
          "name": "OMiT Noir"
        },
        "toTeam": {
          "slug": "omit",
          "name": "OMiT"
        },
        "date": "2025-03-14",
        "role": "Player"
      }
    ]
  }
}

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