Matches

Access match details, live scores, and per-map player statistics

Get Match Details

GET/cod/matches/:id

Get full match details including per-map scores, player stats, and VOD links.

Example Request

GET /api/v1/cod/matches/12588

Response

{
  "success": true,
  "data": {
    "id": "...",
    "matchId": "12588",
    "round": "Winners Round 1",
    "team1": {
      "slug": "optic-texas",
      "name": "OpTic Texas",
      "logoUrl": "..."
    },
    "team2": {
      "slug": "atlanta-faze",
      "name": "Atlanta FaZe",
      "logoUrl": "..."
    },
    "team1Score": 3,
    "team2Score": 1,
    "winnerSlug": "optic-texas",
    "matchDate": "2025-01-28T18:00:00Z",
    "status": "completed",
    "tournament": {
      "name": "CDL Major 1",
      "id": "cdl-major-1-2025"
    },
    "maps": [
      {
        "mapNumber": 1,
        "mapName": "Rewind",
        "mapImageUrl": "https://...",
        "gameMode": "Hardpoint",
        "team1Score": 250,
        "team2Score": 180,
        "played": true,
        "pickedBy": "optic-texas"
      }
    ],
    "playerStats": [...]
  }
}

Get Match Maps

GET/cod/matches/:id/maps

Get per-map breakdown for a match including scores and game modes.

Response

{
  "success": true,
  "data": [
    {
      "mapNumber": 1,
      "mapName": "Rewind",
      "gameMode": "Hardpoint",
      "team1Score": 250,
      "team2Score": 180,
      "winner": "optic-texas",
      "duration": "10:23"
    }
  ]
}

Get Map Player Stats

GET/cod/matches/:id/maps/:mapNumber/player-stats

Get individual player stats for a specific map in a match.

Example Request

GET /api/v1/cod/matches/12588/maps/1/player-stats

Response

{
  "success": true,
  "data": {
    "map": {
      "mapNumber": 1,
      "mapName": "Rewind",
      "gameMode": "Hardpoint"
    },
    "players": [
      {
        "ign": "Shotzzy",
        "team": "optic-texas",
        "kills": 32,
        "deaths": 24,
        "kd": 1.33,
        "damage": 4850,
        "hillTime": "1:45",
        "engagements": 56
      }
    ]
  }
}

Get Live Matches

GET/cod/matches/live

GET/cod/cdl/live

Get currently live matches with real-time scores. Perfect for live score tickers and notifications.

Response

{
  "success": true,
  "isLive": true,
  "count": 1,
  "data": [
    {
      "matchId": "...",
      "tournament": "CDL Major 1",
      "round": "Winners Final",
      "team1": {
        "name": "OpTic Texas",
        "slug": "optic-texas",
        "score": 2
      },
      "team2": {
        "name": "Atlanta FaZe",
        "slug": "atlanta-faze",
        "score": 1
      },
      "currentMap": {
        "mapNumber": 4,
        "mapName": "Highrise",
        "gameMode": "Hardpoint"
      },
      "bestOf": 5,
      "status": "live",
      "startedAt": "2025-01-28T19:00:00Z"
    }
  ]
}

Tournaments

CDL League