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.
| Source | What it gives | When it's available | How the site gets it |
|---|---|---|---|
| NBA weekly Coach's Challenge report | Every challenge with the NBA's final ruling, the call that was challenged and the game clock. The official record. | Mondays, covering games through Sunday | Downloaded 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 lists | The same, for a whole season | 2019-20, 2020-21, 2023-24 and 2024-25 (regular season and playoffs) and the 2025-26 regular season | Loaded 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 latest | Read 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-play | Every challenge, minutes after it happens, with the plays around it | Live | Read 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 playoffs | Live | NBA developer API, key kept private in GitHub |
Each challenge can be checked by up to four sources. The highest one available decides the ruling:
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.
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.
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.
| Check | Tested on | ESPN errors caught | Correct rulings wrongly changed |
|---|---|---|---|
| Replay Archive | 2026-27, all 254 challenges | 4 of 4 | 0 of 243 |
| Foul check | 2025-26, 1,118 challenges ESPN logged as won | 24 of 25 | 2 of 1,093 |
| Foul check | 2026-27, 173 challenges ESPN logged as won | 3 of 4 | 0 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.
Recent/Challenge carries RulingSource, OriginalResult, Fixed and Checks. LastUpdate adds NBAReportThrough, NBAReportThroughText and FixedThisSeason. Each Calls block has confirmed and preliminary counts, and each call Type a Preliminary count: how many of its challenges aren't in a weekly report yet.| Season | Ruling source | Checked against |
|---|---|---|
| 2026-27 | NBA weekly report, then Replay Archive, then ESPN + foul check | Matches the NBA report exactly, by quarter and call type, through the latest report; call types since then are preliminary |
| 2025-26 | NBA 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-25 | NBA 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-23 | ESPN | League 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-21 | NBA full-season lists | Exact, except 11 rows of the 2019-20 list whose typed team is fixed from the list's own video links |