Back to Call of Duty API

Tournaments

Access CDL tournament data including brackets, results, and matches

List Tournaments

GET/cod/tournaments

Get a list of all tournaments including CDL Majors, qualifiers, and amateur events.

Query Parameters

ParameterTypeDescription
gamestringFilter by game (bo6, mw3, etc.)
tierstringFilter by tier (S, A, B)
seasonstringFilter by season
completedbooleanOnly completed tournaments
limitnumberResults per page
offsetnumberPagination offset

Example Request

GET /api/v1/cod/tournaments?game=bo6&tier=S&limit=20

Response

{
  "success": true,
  "count": 20,
  "data": [
    {
      "id": "cdl-major-1-2025",
      "name": "CDL Major 1 2025",
      "game": "bo6",
      "tier": "S",
      "startDate": "2025-01-24",
      "endDate": "2025-01-26",
      "prizePool": 500000,
      "location": "Los Angeles, CA",
      "status": "completed"
    }
  ]
}

Get Tournament Details

GET/cod/tournaments/:id

Get full tournament info with placements, prize pool breakdown, and recent matches.

Example Request

GET /api/v1/cod/tournaments/cdl-major-1-2025

Response

{
  "success": true,
  "data": {
    "id": "cdl-major-1-2025",
    "name": "CDL Major 1 2025",
    "game": "bo6",
    "tier": "S",
    "startDate": "2025-01-24",
    "endDate": "2025-01-26",
    "prizePool": 500000,
    "location": "Los Angeles, CA",
    "status": "completed",
    "teams": 12,
    "format": "Double Elimination",
    "winner": {
      "slug": "atlanta-faze",
      "name": "Atlanta FaZe"
    }
  }
}

Get Tournament Results

GET/cod/tournaments/:id/results

Get final standings and placements for a tournament with prize distribution.

Response

{
  "success": true,
  "data": [
    {
      "placement": 1,
      "team": {
        "slug": "atlanta-faze",
        "name": "Atlanta FaZe"
      },
      "prize": 200000,
      "cdlPoints": 50
    },
    {
      "placement": 2,
      "team": {
        "slug": "optic-texas",
        "name": "OpTic Texas"
      },
      "prize": 120000,
      "cdlPoints": 40
    }
  ]
}

Get Tournament Matches

GET/cod/tournaments/:id/matches

Get all matches for a tournament, filterable by round or status.

Query Parameters

ParameterTypeDescription
roundstringFilter by round name
statusstringFilter by status (scheduled, live, completed)
limitnumberResults per page
offsetnumberPagination offset

Get Tournament Bracket

GET/cod/tournaments/:id/bracket

Get bracket visualization data including winners bracket, losers bracket, and grand finals with match connections.

Response

{
  "success": true,
  "data": {
    "format": "Double Elimination",
    "winners": [
      {
        "round": "Winners Round 1",
        "matches": [
          {
            "matchId": "12345",
            "team1": { "slug": "optic-texas", "seed": 1 },
            "team2": { "slug": "nysl", "seed": 8 },
            "winner": "optic-texas",
            "score": "3-0",
            "nextMatchId": "12350"
          }
        ]
      }
    ],
    "losers": [...],
    "grandFinals": {...}
  }
}