← Coach's challenge tracker

Where the numbers come from, and how they're checked

Every coach's challenge starts from ESPN's play-by-play, because it's posted within minutes of each game. Each morning, every ruling is checked against the NBA's own records. When an NBA source disagrees with ESPN, the NBA wins, and the site shows what changed and why.

The sources

SourceWhat it givesWhen it's availableHow the site gets it
NBA weekly Coach's Challenge reportEvery challenge with the NBA's final ruling, the call that was challenged and the game clock. The official record.Mondays, covering games through SundayDownloaded from the NBA officials site at 9 AM; if it isn't posted yet, rechecked every hour until 3 PM ET. If the PDF reader can't be installed, the update goes ahead with the reports already loaded
NBA full-season listsThe same, for a whole season2019-20, 2020-21, 2023-24 and 2024-25 (regular season and playoffs) and the 2025-26 regular seasonLoaded once from the NBA's PDFs
NBA Replay Archive (official.nba.com)A page for each challenge stating the NBA's ruling, e.g. "would stand" or "overturned to Heat's ball", and in its title what was challenged (foul, out of bounds or goaltending)The same night, usually by about 10 PM ET and by 2 AM at the latestRead every morning, and hourly until 3 PM ET while any challenge lacks a page; each page is matched by game, quarter and clock
ESPN play-by-playEvery challenge, minutes after it happens, with the plays around itLiveRead every morning; the last three days are re-read in case ESPN finished logging late
NBA play-by-play (api.nba.com)A cross-check; filled 4 challenges ESPN missed in the 2025-26 playoffsLiveNBA developer API, key kept private in GitHub

Every morning at 9 AM ET

  1. Collect last night's games and every challenge from ESPN's play-by-play.
  2. Run the foul check on each challenge ESPN logged as won (below).
  3. Read any new Replay Archive pages and match them to challenges.
  4. Download a new NBA weekly report if one is out, and apply it and every earlier report.
  5. Decide each ruling by the order below, rebuild every table and the XPression XML, and write a log entry for the update.
  6. Until 3 PM ET, hourly runs look again for anything that wasn't out at 9 AM: Monday's NBA report if it's posted late, and Replay Archive pages for challenges still resting on ESPN alone (often late West Coast games). If either turns up, the site and XML are rebuilt.
  7. Confirm that every one of last night's games is in. If any are still missing, retry every hour; if they're still missing after 1 PM ET, the job fails and GitHub emails an alert.

How each ruling is decided

Each challenge can be checked by up to four sources. The highest one available decides the ruling:

NBA weekly reportThe NBA's own record and the final word. Once a report covers a game, any challenge ESPN logged that the report doesn't list is removed, and any it lists that ESPN missed is added.
NBA Replay ArchiveThe NBA's ruling for each challenge, posted the same night, and the type of call challenged. It covers games until Monday's report arrives.
ESPN play-by-play with the foul checkUsed only for the few challenges without an archive page, about 3% this season.

What gets fixed, and why

ESPN's most common mistake is a ruling, not a missing challenge. Since 2024-25, when replay reverses an out-of-bounds call it also checks for a foul just before it. If it finds a foul by the challenging team, the other team keeps the ball, and the NBA scores the challenge as lost. ESPN's feed still logs "call overturned," and so does the NBA's own play-by-play.

Example, Nov. 7, 2026, Knicks at Cavaliers: Cleveland challenged an out-of-bounds call with 43.7 seconds left. ESPN logged "call overturned." The Replay Archive page says the Knicks' ball "would stand as the Cavaliers' Mitchell was assessed a defensive foul." The NBA's report scores it as a lost challenge. The site shows it as Call stood with a Fixed mark.

The foul check. In ESPN's play-by-play, these reversals are followed at the same game clock by a foul on the challenging team. When ESPN logs a won challenge, the site looks for that foul. Fouls marked "away from play," technicals and flagrants are ignored. If it finds one, the challenge is counted as lost until an NBA source says otherwise.

Rule check and hand-checked corrections. Every build checks each team's challenges in every game against the rule: one challenge per team per game through 2022-23, and since 2023-24 a second only after winning the first (never three). Anything that breaks it is printed in the build log and checked by hand against the NBA's Replay Archive or the game's play-by-play; each fix is listed with its source in data/challenges/corrections.json. In November 2026 this found ESPN crediting challenges to the wrong team (Warriors at Hornets, Oct. 29, 2022; Wizards at Thunder, Jan. 6, 2023; Kings at Thunder, Feb. 26, 2023; Grizzlies at Spurs, March 17, 2023), a referee-requested review logged as a challenge (Raptors at 76ers, April 18, 2022, playoffs), a team slip in the NBA's own 2024-25 list (Magic at Pacers, April 11, 2025: three challenges credited to Indiana; the Replay Archive and both play-by-plays show one was Orlando's), and the site attaching a challenge to the night before when two teams played back-to-back (Trail Blazers at Timberwolves, March 13 and 14, 2021; fixed in the code). The NBA's 2019-20 list has a few typed team slips (a team not in the game, or two rows swapped); its video links name the challenging team, so where a link and ESPN agree on the other team, the link's team is used (11 challenges).

The Replay Archive check. Each archive page is read for its ruling ("would stand" or "overturned") and replaces ESPN's. Its title also gives the type of call challenged, so the call-type table includes last night's challenges right away (marked preliminary). The kind of foul (defensive, offensive, loose ball) comes from ESPN's play-by-play until the weekly report.

The NBA report check. The report replaces any earlier ruling and also fixes the challenging team, quarter and call type where ESPN had them wrong. The game clock shown is the report's: ESPN's play-by-play often differs by about a second, and the original ESPN clock is noted in that challenge's checks.

How the checks were tested

Before they went live, the checks were tested against the NBA's own final rulings: the full 2025-26 regular-season list and this season's reports through Nov. 8.

CheckTested onESPN errors caughtCorrect rulings wrongly changed
Replay Archive2026-27, all 254 challenges4 of 40 of 243
Foul check2025-26, 1,118 challenges ESPN logged as won24 of 252 of 1,093
Foul check2026-27, 173 challenges ESPN logged as won3 of 40 of 169

Applied in order, the checks would have shown no wrong rulings on any day this season. Without them, the site showed 4 wrong rulings between weekly reports. Two other ideas were rejected because they changed too many correct rulings: tracking which team got the ball next, and the NBA play-by-play's possession field.

Where to see the checks

Past seasons

SeasonRuling sourceChecked against
2026-27NBA weekly report, then Replay Archive, then ESPN + foul checkMatches the NBA report exactly, by quarter and call type, through the latest report; call types since then are preliminary
2025-26NBA full-season list (regular season); ESPN + NBA play-by-play (playoffs)Regular season exact. Playoffs: 131 challenges, matching the NBA total; one win short (87 vs 88)
2023-24, 2024-25NBA full-season lists (regular season and playoffs)Exact (one 2024-25 team fixed by hand, below). Before these lists were added in November 2026, ESPN had 2024-25 rulings wrong on 49 challenges (about 3%), 17 challenges missing and 14 extra
2021-22, 2022-23ESPNLeague totals within about 1% of NBA figures published in the press; every team-game checked against the challenge rule. The NBA's lists for these two seasons are no longer posted anywhere we could find
2019-20, 2020-21NBA full-season listsExact, except 11 rows of the 2019-20 list whose typed team is fixed from the list's own video links

What can still be wrong