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/Tournaments

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

Parameter	Type	Description
`game`	string	Filter by game (bo6, mw3, etc.)
`tier`	string	Filter by tier (S, A, B)
`season`	string	Filter by season
`completed`	boolean	Only completed tournaments
`limit`	number	Results per page
`offset`	number	Pagination 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

Parameter	Type	Description
`round`	string	Filter by round name
`status`	string	Filter by status (scheduled, live, completed)
`limit`	number	Results per page
`offset`	number	Pagination 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": {...}
  }
}

Players

Matches