Docs/Call of Duty API/Organizations / Teams

Organizations / Teams

Access CDL team data including rosters, transfers, and match stats

List All Organizations

GET/cod/orgs

GET/cod/teams

Get a list of all COD esports teams/organizations. Use this to display team listings, filter by region, or get only CDL franchise teams.

Query Parameters

Parameter	Type	Description
`region`	string	Filter by region (NA, EU, etc.)
`franchiseOnly`	boolean	Only show CDL franchise teams
`limit`	number	Results per page (default: 50)
`offset`	number	Pagination offset

Example Request

GET /api/v1/cod/orgs?franchiseOnly=true&limit=12

Response

{
  "success": true,
  "count": 12,
  "total": 12,
  "data": [
    {
      "slug": "optic-texas",
      "name": "OpTic Texas",
      "shortName": "OpTic",
      "logoUrl": "https://...",
      "region": "NA",
      "city": "Texas",
      "franchiseSlot": true,
      "approxTotalWinnings": 5000000
    }
  ]
}

Get Organization Details

GET/cod/orgs/:slug

GET/cod/teams/:slug

Get detailed info about a specific team including roster count, transfer history, and total earnings.

Example Request

GET /api/v1/cod/orgs/optic-texas

Response

{
  "success": true,
  "data": {
    "slug": "optic-texas",
    "name": "OpTic Texas",
    "shortName": "OpTic",
    "logoUrl": "https://...",
    "region": "NA",
    "city": "Texas",
    "franchiseSlot": true,
    "founded": 2021,
    "approxTotalWinnings": 5000000,
    "rosterCount": 4,
    "social": {
      "twitter": "OpTicTexas",
      "youtube": "OpTicTexas"
    }
  }
}

Get Organization Roster

GET/cod/orgs/:slug/roster

GET/cod/teams/:slug/roster

Get the current active roster for a team, including player roles and nationalities.

Query Parameters

Parameter	Type	Description
`includeInactive`	boolean	Include former players

Example Request

GET /api/v1/cod/teams/atlanta-faze/roster

Response

{
  "success": true,
  "data": {
    "team": {
      "slug": "atlanta-faze",
      "name": "Atlanta FaZe"
    },
    "roster": [
      {
        "codPlayerId": "...",
        "ign": "Simp",
        "realName": "Chris Lehr",
        "role": "Player",
        "nationality": "US",
        "imageUrl": "https://..."
      }
    ]
  }
}

Get Organization Transfers

GET/cod/orgs/:slug/transfers

GET/cod/teams/:slug/transfers

View transfer history for a team including player acquisitions and releases.

Query Parameters

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

Response

{
  "success": true,
  "data": [
    {
      "playerId": "...",
      "playerIgn": "Dashy",
      "transferType": "signed",
      "fromTeam": null,
      "toTeam": "optic-texas",
      "date": "2024-09-01"
    }
  ]
}

Get Organization Match Results

GET/cod/orgs/:slug/results

GET/cod/teams/:slug/results

Get historical match results for a team, filterable by season.

Query Parameters

Parameter	Type	Description
`season`	string	Filter by season (e.g., "2025")
`limit`	number	Results per page
`offset`	number	Pagination offset

Get Organization Upcoming Matches

GET/cod/orgs/:slug/upcoming-matches

GET/cod/teams/:slug/upcoming-matches

Get scheduled upcoming matches for a team.

Example Request

GET /api/v1/cod/teams/optic-texas/upcoming-matches

Response

{
  "success": true,
  "data": [
    {
      "matchId": "12345",
      "opponent": {
        "slug": "atlanta-faze",
        "name": "Atlanta FaZe"
      },
      "tournament": "CDL Major 2",
      "scheduledDate": "2025-02-15T19:00:00Z",
      "round": "Group Stage"
    }
  ]
}

Get Organization Recent Matches

GET/cod/orgs/:slug/recent-matches

GET/cod/teams/:slug/recent-matches

Get recently completed matches for a team with win/loss results.

Query Parameters

Parameter	Type	Description
`limit`	number	Number of matches (default: 10)

Get Organization Record

GET/cod/orgs/:slug/record

GET/cod/teams/:slug/record

Get win/loss record and stats for a team, optionally filtered by season or tournament.

Query Parameters

Parameter	Type	Description
`season`	string	Filter by season
`tournamentId`	string	Filter by specific tournament

Response

{
  "success": true,
  "data": {
    "team": "OpTic Texas",
    "season": "2025",
    "matchRecord": {
      "wins": 24,
      "losses": 12,
      "winPct": 0.667
    },
    "mapRecord": {
      "wins": 78,
      "losses": 52,
      "winPct": 0.6
    }
  }
}

Get Team Map Stats

GET/cod/orgs/:slug/map-stats

GET/cod/teams/:slug/map-stats

Get map-by-map performance stats including pick rates and win rates by game mode.

Example Request

GET /api/v1/cod/teams/atlanta-faze/map-stats

Response

{
  "success": true,
  "data": {
    "team": "Atlanta FaZe",
    "maps": [
      {
        "mapName": "Rewind",
        "modes": {
          "hardpoint": { "played": 15, "wins": 10, "winPct": 0.667 },
          "control": { "played": 8, "wins": 6, "winPct": 0.75 }
        },
        "totalPlayed": 23,
        "pickRate": 0.45
      }
    ]
  }
}

Players