Docs/Call of Duty API/CDL League

CDL League

Access Black Ops 7 Call of Duty League standings, schedules, and live data

Get CDL Standings

GET/cod/cdl/standings

GET/cod/standings

Get current Black Ops 7 CDL season standings with points, match records, and map records for all 12 franchise teams.

Query Parameters

Parameter	Type	Description
`season`	string	Season year (default: current)
`stage`	string	CDL stage/major

Example Request

GET /api/v1/cod/cdl/standings?season=2026

Response

{
  "success": true,
  "season": "2026",
  "data": [
    {
      "rank": 1,
      "orgSlug": "optic-texas",
      "teamName": "OpTic Texas",
      "teamLogo": "https://...",
      "cdlPoints": 300,
      "matchRecord": {
        "wins": 21,
        "losses": 6,
        "winPct": 0.778
      },
      "mapRecord": {
        "wins": 70,
        "losses": 33,
        "winPct": 0.68
      }
    },
    {
      "rank": 2,
      "orgSlug": "faze-vegas",
      "teamName": "FaZe Vegas",
      "teamLogo": "https://...",
      "cdlPoints": 290,
      "matchRecord": {
        "wins": 7,
        "losses": 3,
        "winPct": 0.7
      },
      "mapRecord": {
        "wins": 25,
        "losses": 14,
        "winPct": 0.64
      }
    }
  ]
}

Get CDL Schedule

GET/cod/cdl/schedule

GET/cod/schedule

Get upcoming Black Ops 7 CDL match schedule including Major, qualifier, and championship events. Team filters accept slugs, names, short codes, and common previous names.

Query Parameters

Parameter	Type	Description
`upcoming`	boolean	Only show upcoming matches (default: true)
`team`	string	Filter by team slug, name, short code, or known alias (example: toronto-koi, Toronto KOI, TOR, Toronto Ultra)
`includeChallengers`	boolean	Set true to include broader Challengers/CDC schedule rows where available

Example Request

GET /api/v1/cod/cdl/schedule?team=Toronto%20KOI&limit=5

Response

{
  "success": true,
  "source": "database",
  "count": 5,
  "filters": {
    "upcoming": true,
    "cdlOnly": true,
    "team": "Toronto KOI"
  },
  "data": [
    {
      "matchId": "bp-match-332876",
      "startsAt": "2026-05-15T18:30:00.000Z",
      "team1": {
        "slug": "toronto-koi",
        "name": "Toronto KOI"
      },
      "team2": {
        "slug": "huntsmen",
        "name": "Huntsmen"
      },
      "tournament": {
        "name": "CDL Major 3 Tournament"
      },
      "round": "Group Play B Winners Round 1",
      "status": "scheduled"
    }
  ]
}

Get Live CDL Matches

GET/cod/cdl/live

Get currently live Black Ops 7 CDL matches with near real-time scores. During live match windows, COD data is automatically checked roughly every 30-60 seconds.

Response

{
  "success": true,
  "isLive": true,
  "count": 1,
  "data": [
    {
      "matchId": "12605",
      "team1": {
        "name": "OpTic Texas",
        "score": 2
      },
      "team2": {
        "name": "Atlanta FaZe",
        "score": 1
      },
      "currentMap": 4,
      "status": "live",
      "tournament": "CDL Major 2"
    }
  ]
}

Matches

Transfers