What's inside a box score
The schedule gives you a score. The game detail gives you the game. This is a real response, Game 5 of the 2026 NBA Finals, in which the Knicks won the title in San Antonio.
curl -H "X-RapidAPI-Key: YOUR_KEY" \
-H "X-RapidAPI-Host: nba206.p.rapidapi.com" \
"https://nba206.p.rapidapi.com/games/145529959"
The top level
{
"id": 145529959,
"competition": "nba",
"season": "2025-26",
"stage": "finals",
"gameNumber": 5,
"tipoff": "2026-06-14T00:30:00.000Z",
"status": "finished",
"period": null,
"clock": null,
"homeTeam": { "id": 720043634, "slug": "san-antonio-spurs", "name": "San Antonio Spurs", "code": "SAS", ... },
"awayTeam": { "id": 807374125, "slug": "new-york-knicks", "name": "New York Knicks", "code": "NYK", ... },
"score": { "home": 90, "away": 94 },
"series": { "home": 1, "away": 4 },
"venue": "Frost Bank Center",
"periods": [
{ "period": "Q1", "home": 23, "away": 13 },
{ "period": "Q2", "home": 19, "away": 24 },
{ "period": "Q3", "home": 30, "away": 28 },
{ "period": "Q4", "home": 18, "away": 29 }
],
"attendance": 18984,
"boxScore": { "home": { ... }, "away": { ... } }
}
A few of these are easy to misread:
tipoffis UTC. This game started at 7:30 in the evening in San Antonio, which is already the 14th in UTC. Convert before you print a date, or a late game lands on the wrong day.seriescounts games won in the series with this one included. Knicks 4, Spurs 1 is the final series score. It isnulloutside a playoff series.periodsis the score of each period, not the running total. The Spurs led 42-37 at half time and 72-65 after three, and lost the fourth quarter 29-18. An overtime adds anOTentry, a second oneOT2.
One player's line
boxScore has a side per team, each with starters, bench and
totals. This is the first Knicks starter:
{
"player": {
"id": 1317561569,
"slug": "jalen-brunson",
"name": "Jalen Brunson",
"photoUrl": "https://basketball-api.yuvron.online/images/player/1317561569.png"
},
"shirtNumber": 11,
"position": "PG",
"played": true,
"minutes": "41:07",
"seconds": 2467,
"points": 45,
"rebounds": 3,
"offensiveRebounds": 1,
"defensiveRebounds": 2,
"assists": 3,
"steals": 2,
"blocks": 0,
"turnovers": 3,
"fouls": 1,
"fieldGoalsMade": 14,
"fieldGoalsAttempted": 27,
"threePointersMade": 4,
"threePointersAttempted": 7,
"freeThrowsMade": 13,
"freeThrowsAttempted": 15,
"plusMinus": 10
}
minutes is for printing and seconds is for arithmetic. Add up the
seconds of one team and you get 14,400 for a game without overtime: five players on
the floor for 48 minutes. That makes a quick check that a box score is whole.
fieldGoalsMade counts every basket from the floor, threes included. So Brunson's 45
points are 10 twos (20 points), 4 threes (12) and 13 free throws (13).
plusMinus is the score difference while the player was on the floor: the Knicks
outscored San Antonio by 10 in his 41 minutes. The EuroLeague does not keep it, so there the field
is null rather than 0.
Bench players who never came on are listed with played: false and zeros
everywhere. Three Knicks sat out this game. Filter on played before you average
anything, or a bench full of zeros drags every mean down.
Numbers you can build from it
The shooting splits are raw makes and attempts on purpose: every efficiency figure people quote is a sum of these. True shooting percentage, which counts free throws and threes at their real value, is
const trueShooting = (p) =>
p.points / (2 * (p.fieldGoalsAttempted + 0.44 * p.freeThrowsAttempted));
trueShooting(brunson); // 0.670
Brunson took 27 shots and made 14, which is 52%. His true shooting was 67%, because 13 of his points came from the line. The same game as a team: the Knicks shot 31 for 87 (36%) and still won, on 28 free-throw attempts to San Antonio's 19.
totals on each side is the team line, so you do not have to sum it yourself:
"totals": {
"points": 94, "rebounds": 48, "offensiveRebounds": 13, "defensiveRebounds": 35,
"assists": 14, "steals": 8, "blocks": 4, "turnovers": 10, "fouls": 21,
"fieldGoalsMade": 31, "fieldGoalsAttempted": 87,
"threePointersMade": 12, "threePointersAttempted": 37,
"freeThrowsMade": 20, "freeThrowsAttempted": 28
}
When the box score is there
boxScore is null for a game that has not started, and filled from
tip-off on, refreshed every 30 seconds while the game is live. The same lines, one per game, are
behind /players/{id}/games, and the season totals and per-game averages behind
/players/{id} are built from them.