Docs/Game APIs/Call of Duty

Call of Duty API

Complete Black Ops 7 CDL esports data: teams, players, matches, tournaments & analytics

BASEhttps://api.citoapi.com/api/v1
API RootAppend any Call of Duty endpoint path below.

Organizations / Teams

List teams, get rosters, transfers, earnings, match results, and map stats

GET/api/v1/cod/orgs
Organizations & TeamsGet current & historical CDL teams with logos, franchise status, and rebrand history.

Widget Preview

CDL organization list

Live proxy

Quick Start

curl "https://api.citoapi.com/api/v1/cod/orgs?franchiseOnly=true&limit=12" \
  -H "x-api-key: YOUR_CITO_API_KEY"
GET/api/v1/cod/orgs/{slug}
Get OrganizationGet a specific organization by slug

Widget Preview

Organization profile

optic-texas

Quick Start

curl "https://api.citoapi.com/api/v1/cod/orgs/optic-texas" \
  -H "x-api-key: YOUR_CITO_API_KEY"
GET/api/v1/cod/orgs/{slug}/roster
Organization RosterRender a clean current roster for one CDL organization with player identity, role, image, and historical context.

Widget Preview

Current roster

optic-texas

Quick Start

curl "https://api.citoapi.com/api/v1/cod/orgs/optic-texas/roster" \
  -H "x-api-key: YOUR_CITO_API_KEY"
GET/api/v1/cod/teams/{slug}/matches
Team MatchesGet a team's match history with pagination and filters

Widget Preview

Team Matches

optic-texas

Quick Start

curl "https://api.citoapi.com/api/v1/cod/teams/optic-texas/matches" \
  -H "x-api-key: YOUR_CITO_API_KEY"
GET/api/v1/cod/teams/{slug}/recent-matches
Team Recent MatchesGet recently completed matches for one team

Widget Preview

Team Recent Matches

optic-texas

Quick Start

curl "https://api.citoapi.com/api/v1/cod/teams/optic-texas/recent-matches" \
  -H "x-api-key: YOUR_CITO_API_KEY"
GET/api/v1/cod/teams/{slug}/upcoming-matches
Team Upcoming MatchesGet upcoming scheduled matches for one team

Widget Preview

Team Upcoming Matches

optic-texas

Quick Start

curl "https://api.citoapi.com/api/v1/cod/teams/optic-texas/upcoming-matches" \
  -H "x-api-key: YOUR_CITO_API_KEY"
GET/api/v1/cod/teams/{slug}/record
Team RecordGet match and map record for one team

Widget Preview

Team Record

optic-texas

Quick Start

curl "https://api.citoapi.com/api/v1/cod/teams/optic-texas/record" \
  -H "x-api-key: YOUR_CITO_API_KEY"
GET/api/v1/cod/teams/{slug}/map-stats
Team Map StatsGet map/mode pick rates, ban rates, win rates, and score stats

Widget Preview

Team Map Stats

optic-texas

Quick Start

curl "https://api.citoapi.com/api/v1/cod/teams/optic-texas/map-stats" \
  -H "x-api-key: YOUR_CITO_API_KEY"
GET/api/v1/cod/teams/{slug}/stats
Team StatsGet aggregate team performance stats

Widget Preview

Team Stats

optic-texas

Quick Start

curl "https://api.citoapi.com/api/v1/cod/teams/optic-texas/stats" \
  -H "x-api-key: YOUR_CITO_API_KEY"
GET/api/v1/cod/teams/{slug}/transfers
Team TransfersGet roster moves involving one team

Widget Preview

Team Transfers

g2-minnesota

Quick Start

curl "https://api.citoapi.com/api/v1/cod/teams/g2-minnesota/transfers" \
  -H "x-api-key: YOUR_CITO_API_KEY"
GET/api/v1/cod/teams/{slug}/results
Team ResultsGet tournament placement and result rows for one team

Widget Preview

Team Results

optic-texas

Quick Start

curl "https://api.citoapi.com/api/v1/cod/teams/optic-texas/results" \
  -H "x-api-key: YOUR_CITO_API_KEY"
GET/api/v1/cod/orgs/{slug}/earnings
Org EarningsAlias for organization prize earnings

Widget Preview

Org Earnings

optic-texas

Quick Start

curl "https://api.citoapi.com/api/v1/cod/orgs/optic-texas/earnings" \
  -H "x-api-key: YOUR_CITO_API_KEY"

Players

Player profiles, earnings, transfers, stats, and match history

GET/api/v1/cod/players
Player DirectoryList COD players with normalized identity fields so discovery, search, and profile linking feel reliable.

Widget Preview

List Players

shotzzy

Quick Start

curl "https://api.citoapi.com/api/v1/cod/players" \
  -H "x-api-key: YOUR_CITO_API_KEY"
GET/api/v1/cod/players/{id}
Player ProfilePull one player profile with identity, current team, earnings summary, roster history, and media fields.

Widget Preview

Get Player

shotzzy

Quick Start

curl "https://api.citoapi.com/api/v1/cod/players/shotzzy" \
  -H "x-api-key: YOUR_CITO_API_KEY"
GET/api/v1/cod/players/{id}/stats
Player StatsGet aggregate player stats by season, team, and mode where available

Widget Preview

Player Stats

shotzzy

Quick Start

curl "https://api.citoapi.com/api/v1/cod/players/shotzzy/stats" \
  -H "x-api-key: YOUR_CITO_API_KEY"
GET/api/v1/cod/players/{id}/matches
Player MatchesGet matches played by one player

Widget Preview

Player Matches

shotzzy

Quick Start

curl "https://api.citoapi.com/api/v1/cod/players/shotzzy/matches" \
  -H "x-api-key: YOUR_CITO_API_KEY"
GET/api/v1/cod/players/{id}/upcoming-matches
Player Upcoming MatchesGet upcoming matches for a player's current team

Widget Preview

Player Upcoming Matches

shotzzy

Quick Start

curl "https://api.citoapi.com/api/v1/cod/players/shotzzy/upcoming-matches" \
  -H "x-api-key: YOUR_CITO_API_KEY"
GET/api/v1/cod/players/{id}/earnings
Player EarningsGet player earnings history

Widget Preview

Player Earnings

shotzzy

Quick Start

curl "https://api.citoapi.com/api/v1/cod/players/shotzzy/earnings" \
  -H "x-api-key: YOUR_CITO_API_KEY"
GET/api/v1/cod/players/{id}/transfers
Player TransfersGet player roster movement history

Widget Preview

Player Transfers

bance

Quick Start

curl "https://api.citoapi.com/api/v1/cod/players/bance/transfers" \
  -H "x-api-key: YOUR_CITO_API_KEY"

Tournaments

Tournament listings, brackets, results, and matches

GET/api/v1/cod/tournaments
Tournament ListDiscover CDL and Challengers events with persistent canonical IDs, source season, normalized season year, dates, and prize data.

Widget Preview

List Tournaments

codwiki-call-of-duty-league-2026-major-3

Quick Start

curl "https://api.citoapi.com/api/v1/cod/tournaments" \
  -H "x-api-key: YOUR_CITO_API_KEY"
GET/api/v1/cod/tournaments/{id}
Tournament DetailGet one merged tournament response with results and matches combined across Breaking Point and COD Wiki sources.

Widget Preview

Tournament Detail

codwiki-call-of-duty-league-2026-major-3

Quick Start

curl "https://api.citoapi.com/api/v1/cod/tournaments/codwiki-call-of-duty-league-2026-major-3" \
  -H "x-api-key: YOUR_CITO_API_KEY"
GET/api/v1/cod/tournaments/{id}/results
Tournament ResultsGet placements, prize rows, and team results for a tournament

Widget Preview

Tournament Results

codwiki-call-of-duty-league-2026-major-3

Quick Start

curl "https://api.citoapi.com/api/v1/cod/tournaments/codwiki-call-of-duty-league-2026-major-3/results" \
  -H "x-api-key: YOUR_CITO_API_KEY"
GET/api/v1/cod/tournaments/{id}/matches
Tournament MatchesGet all matches for a tournament

Widget Preview

Tournament Matches

bp-107

Quick Start

curl "https://api.citoapi.com/api/v1/cod/tournaments/bp-107/matches" \
  -H "x-api-key: YOUR_CITO_API_KEY"
GET/api/v1/cod/tournaments/{id}/bracket
Tournament BracketGet bracket rounds and match positions where available

Widget Preview

Tournament Bracket

bp-107

Quick Start

curl "https://api.citoapi.com/api/v1/cod/tournaments/bp-107/bracket" \
  -H "x-api-key: YOUR_CITO_API_KEY"

Matches

Match details, map breakdowns, player stats, and live matches

GET/api/v1/cod/matches/live
Live MatchesCheck current COD matches with professional live-state handling so stale rows do not look live.

Widget Preview

Live Matches

bp-match-341535

Quick Start

curl "https://api.citoapi.com/api/v1/cod/matches/live" \
  -H "x-api-key: YOUR_CITO_API_KEY"
GET/api/v1/cod/matches
Match HistoryGet paginated historical CoD matches by season, date range, team, or tournament

Widget Preview

Match History

bp-match-341535

Quick Start

curl "https://api.citoapi.com/api/v1/cod/matches" \
  -H "x-api-key: YOUR_CITO_API_KEY"
GET/api/v1/cod/matches/recent
Recent MatchesGet recently completed CoD matches with pagination and filters

Widget Preview

Recent Matches

bp-match-341535

Quick Start

curl "https://api.citoapi.com/api/v1/cod/matches/recent" \
  -H "x-api-key: YOUR_CITO_API_KEY"
GET/api/v1/cod/matches/upcoming
Upcoming MatchesGet upcoming scheduled CoD matches

Widget Preview

Upcoming Matches

bp-match-341535

Quick Start

curl "https://api.citoapi.com/api/v1/cod/matches/upcoming?team=optic-texas" \
  -H "x-api-key: YOUR_CITO_API_KEY"
GET/api/v1/cod/matches/{id}
Match DetailGet one match with teams, score, tournament context, maps, and metadata

Widget Preview

Match Detail

bp-match-341535

Quick Start

curl "https://api.citoapi.com/api/v1/cod/matches/bp-match-341535" \
  -H "x-api-key: YOUR_CITO_API_KEY"
GET/api/v1/cod/matches/{id}/maps
Match MapsGet map-by-map scores, modes, winners, breakdowns, and grouped player stat rows

Widget Preview

Match Maps

bp-match-341535

Quick Start

curl "https://api.citoapi.com/api/v1/cod/matches/bp-match-341535/maps" \
  -H "x-api-key: YOUR_CITO_API_KEY"
GET/api/v1/cod/matches/{id}/player-stats
Match Player StatsGet match-level per-player totals with optional per-map/game breakdowns

Widget Preview

Match Player Stats

bp-match-341535

Quick Start

curl "https://api.citoapi.com/api/v1/cod/matches/bp-match-341535/player-stats" \
  -H "x-api-key: YOUR_CITO_API_KEY"
GET/api/v1/cod/matches/{id}/maps/{mapNumber}/player-stats
Map Player StatsGet one map's player table: kills, deaths, K/D, damage, hill time/objective stats, first bloods, and BP ratings

Widget Preview

Map Player Stats

bp-match-341535

Quick Start

curl "https://api.citoapi.com/api/v1/cod/matches/bp-match-341535/maps/1/player-stats" \
  -H "x-api-key: YOUR_CITO_API_KEY"

CDL League

Black Ops 7 CDL standings, schedule, seasons, and live matches

GET/api/v1/cod/seasons
SeasonsList COD/CDL seasons available in the database

Widget Preview

Seasons

optic-texas

Quick Start

curl "https://api.citoapi.com/api/v1/cod/seasons" \
  -H "x-api-key: YOUR_CITO_API_KEY"
GET/api/v1/cod/cdl/standings
CDL StandingsRender current CDL league standings with ranks, records, map records, points, team logos, and freshness metadata.

Widget Preview

CDL Standings

optic-texas

Quick Start

curl "https://api.citoapi.com/api/v1/cod/cdl/standings" \
  -H "x-api-key: YOUR_CITO_API_KEY"
GET/api/v1/cod/standings
StandingsAlias for CDL standings

Widget Preview

Standings

optic-texas

Quick Start

curl "https://api.citoapi.com/api/v1/cod/standings" \
  -H "x-api-key: YOUR_CITO_API_KEY"
GET/api/v1/cod/cdl/schedule
CDL ScheduleGet upcoming Black Ops 7 CDL matches

Widget Preview

CDL Schedule

optic-texas

Quick Start

curl "https://api.citoapi.com/api/v1/cod/cdl/schedule" \
  -H "x-api-key: YOUR_CITO_API_KEY"
GET/api/v1/cod/schedule
ScheduleAlias for CDL schedule

Widget Preview

Schedule

optic-texas

Quick Start

curl "https://api.citoapi.com/api/v1/cod/schedule?team=optic-texas" \
  -H "x-api-key: YOUR_CITO_API_KEY"
GET/api/v1/cod/cdl/live
CDL LiveGet current live or in-progress CDL matches

Widget Preview

CDL Live

optic-texas

Quick Start

curl "https://api.citoapi.com/api/v1/cod/cdl/live" \
  -H "x-api-key: YOUR_CITO_API_KEY"

Transfers

Roster moves and player transfers

GET/api/v1/cod/transfers
Recent TransfersGet recent player transfers

Widget Preview

Recent Transfers

optic-texas

Quick Start

curl "https://api.citoapi.com/api/v1/cod/transfers?limit=12" \
  -H "x-api-key: YOUR_CITO_API_KEY"

Leaderboards

Earnings and performance leaderboards by mode

GET/api/v1/cod/leaderboards/earnings
Earnings LeaderboardTop earners in CoD esports

Widget Preview

Earnings Leaderboard

optic-texas

Quick Start

curl "https://api.citoapi.com/api/v1/cod/leaderboards/earnings?limit=12" \
  -H "x-api-key: YOUR_CITO_API_KEY"
GET/api/v1/cod/leaderboards/{mode}
Mode LeaderboardGet player leaderboards by hardpoint, snd, control, kd, kills, damage, or earnings

Widget Preview

Mode Leaderboard

optic-texas

Quick Start

curl "https://api.citoapi.com/api/v1/cod/leaderboards/kd?limit=12" \
  -H "x-api-key: YOUR_CITO_API_KEY"

Search

Global search across players, teams, and tournaments

GET/api/v1/cod/search
SearchSearch players, orgs, tournaments

Widget Preview

Search

optic-texas

Quick Start

curl "https://api.citoapi.com/api/v1/cod/search?q=optic" \
  -H "x-api-key: YOUR_CITO_API_KEY"

Statistics

Aggregate database statistics

GET/api/v1/cod/stats
Database StatsGet COD database coverage counts and sync statistics

Widget Preview

Database Stats

optic-texas

Quick Start

curl "https://api.citoapi.com/api/v1/cod/stats" \
  -H "x-api-key: YOUR_CITO_API_KEY"
GET/api/v1/cod/statistics
Database Stats AliasAlias for COD database coverage statistics

Widget Preview

Database Stats Alias

optic-texas

Quick Start

curl "https://api.citoapi.com/api/v1/cod/statistics" \
  -H "x-api-key: YOUR_CITO_API_KEY"

Analytics

Player trends, clutch factor, head-to-head comparisons

GET/api/v1/cod/analytics/players/{id}/trends
Player TrendsGet player stat trends over time

Widget Preview

Player Trends

optic-texas

Quick Start

curl "https://api.citoapi.com/api/v1/cod/analytics/players/optic-texas/trends" \
  -H "x-api-key: YOUR_CITO_API_KEY"
GET/api/v1/cod/analytics/players/{id}/clutch-factor
Player Clutch FactorGet clutch metrics for one player

Widget Preview

Player Clutch Factor

optic-texas

Quick Start

curl "https://api.citoapi.com/api/v1/cod/analytics/players/optic-texas/clutch-factor" \
  -H "x-api-key: YOUR_CITO_API_KEY"
GET/api/v1/cod/analytics/head-to-head
Player Head To HeadCompare two players head-to-head

Widget Preview

Player Head To Head

optic-texas

Quick Start

curl "https://api.citoapi.com/api/v1/cod/analytics/head-to-head?player1=shotzzy&player2=simp" \
  -H "x-api-key: YOUR_CITO_API_KEY"
GET/api/v1/cod/analytics/compare
Compare PlayersCompare multiple COD players across selected stats

Widget Preview

Compare Players

optic-texas

Quick Start

curl "https://api.citoapi.com/api/v1/cod/analytics/compare?players=shotzzy,simp,abezy&stats=kd,kills,damage" \
  -H "x-api-key: YOUR_CITO_API_KEY"
GET/api/v1/cod/analytics/teams/{slug}/style
Team StyleGet playstyle analysis for one team

Widget Preview

Team Style

optic-texas

Quick Start

curl "https://api.citoapi.com/api/v1/cod/analytics/teams/optic-texas/style" \
  -H "x-api-key: YOUR_CITO_API_KEY"
GET/api/v1/cod/analytics/teams/head-to-head
Team Head To HeadCompare two teams head-to-head

Widget Preview

Team Head To Head

optic-texas

Quick Start

curl "https://api.citoapi.com/api/v1/cod/analytics/teams/head-to-head?team1=optic-texas&team2=g2-minnesota" \
  -H "x-api-key: YOUR_CITO_API_KEY"
GET/api/v1/cod/analytics/teams/map-comparison
Team Map ComparisonCompare team performance by map and mode

Widget Preview

Team Map Comparison

optic-texas

Quick Start

curl "https://api.citoapi.com/api/v1/cod/analytics/teams/map-comparison?team1=optic-texas&team2=g2-minnesota" \
  -H "x-api-key: YOUR_CITO_API_KEY"
GET/api/v1/cod/analytics/leaderboard/{stat}
Analytics LeaderboardGet an analytics leaderboard for one stat

Widget Preview

Analytics Leaderboard

optic-texas

Quick Start

curl "https://api.citoapi.com/api/v1/cod/analytics/leaderboard/kd?limit=12" \
  -H "x-api-key: YOUR_CITO_API_KEY"

Other COD Endpoints

Additional discovery or compatibility paths.

GET/api/v1/cod
COD OverviewDiscover Call of Duty endpoint coverage, counts, and available data surfaces

Widget Preview

COD Overview

optic-texas

Quick Start

curl "https://api.citoapi.com/api/v1/cod" \
  -H "x-api-key: YOUR_CITO_API_KEY"
Quickstart GuideRate LimitsError Handling