Basketball
The NBA (nba), NCAA Division I men’s basketball (ncaab) and the WNBA (wnba) share one data model. A game in any of them fills the same endpoints and the same basketball blocks, so the same code reads all three. The leagues differ in period length and in a few fields, listed under League differences.
The examples come from two recorded games: the Lakers at the Hawks in the NBA on November 9, 2026, and Wagner at UConn in NCAAB the same night.
Live state
live_state on GET /v1/{league}/games/{id} carries the situation in its basketball block. The other sports’ blocks are null.
The basketball block is there only while the game is in progress. After the final it’s null, and period and clock_seconds keep the end of the game, such as period 4 at 0.
Each count is null when the feed doesn’t report it. The feed doesn’t track timeouts and fouls for most college games, so in NCAAB the four counts are often null all game.
Periods and overtime
Every period after regulation is another overtime, so an NBA game’s period 6 is its second overtime and an NCAAB game’s period 3 is its first. Build a scoreboard turns a period number into a label such as 2nd half or 2OT, and the clock section formats clock_seconds.
Plays
GET /v1/{league}/games/{id}/plays lists every event. It returns a page of events, 500 by default and up to 1,000 with limit, with a next_cursor for the rest. Lists, pagination and dates shows how to page. A play’s type and its basketball.play_type are the same value, one of these:
The basketball block on each play:
points and is_scoring say what the play scored, and home_score and away_score are the score after it. team_id is the team credited with the event, which for a shot is the shooting team, even when another team’s player blocked it.
Each play’s participants lists the players in it with a role: shooter, assist, blocker, rebounder, stealer, fouler, player_in and player_out on a substitution, or player for any other part, such as the players in a jump ball or the player who turned it over. A team rebound has no participants. Join each participant’s player_id to players[].id in the game roster response, not to the box score, because a player in a play can have no stat line. description is the feed’s play text.
This is a made three in the NBA sample, from plays.json, unedited:
The Hawks went up 3 to 0 with 11:30 left in the 1st quarter. The assist is a second participant on the same play.
Play groups
Basketball has no drives or possessions in the data. Every play’s group_id is null, and GET /v1/{league}/games/{id}/play-groups returns an empty list.
Box score
GET /v1/{league}/games/{id}/boxscore has one line per player who played. Each line holds one category, basketball:
These are the stats of a Lakers player in the NBA sample, unedited:
Treat every code as optional, and ignore codes you don’t use. Build a scoreboard joins the lines to player names and adds up team totals.
Rosters
GET /v1/{league}/games/{id}/roster lists every player in the box score, with their team, jersey, position (G, F or C) and whether they started. A player who didn’t play is on the roster but has no box-score line.
What isn’t filled yet
Coverage by league lists the gaps every sport shares, such as team totals and the score by period.
League differences
NBA play-in games belong to the postseason, so their season’s type is PST.