Basketball API / Blog

What's inside a box score

4 October 2026 · 6 min read

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:

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.

More

Build a live NBA scoreboard

A working scoreboard in about 70 lines: what /games/live returns, how to print the quarter and the clock, why you poll every 30 seconds, and why the key stays on your server.

Reading an NBA table: games behind, the play-in and ties

What winPct, gamesBehind and zone mean in a standings response, how half a game happens, and why Philadelphia finished above Orlando in 2025-26 on a worse point difference.

Every endpoint mentioned here is in the documentation, and every plan includes them all, the free one too.