Changelog

What changed in the API, newest first.

v1 only ever grows: fields and endpoints are added, never renamed. Anything retired is announced here twelve months ahead.

9 October 2026

Teams: GET /v1/teams/{id} gains city, arena (the club's current home arena), arena_capacity and founded, where known; null elsewhere. The MCP server gains get_team to read them.
Prices are withdrawn: GET /v1/games/{id}/prices and GET /v1/stats/trends no longer answer, /v1/teams/{id}/form no longer carries results against the spread and total, and webhooks no longer offer prices.closing. The MCP server's get_prices and get_trends are gone with them. Games, scores and every other part stay.
Competitions and seasons that hold no games are no longer listed.

10 October 2026

Accounts: signing up and signing in are with Google only. Existing members sign in with the Google account that uses the same email address.
The free key is now a look at the API: yesterday's and today's games and results (score by quarter included), the competitions with their current season, and your usage. Box scores, players, teams and rosters move to Live and above.
Documentation: every endpoint page has Try it, which runs the call with your key, and remembers the key in your browser.

9 October 2026

Players: GET /v1/players/{id} gains awards, the honours a player has received (most valuable player, all-league teams, cup and league titles and more), each with its year where known.
Teams: GET /v1/teams/{id} gains coaches, the club's head coaches, latest first, with the years of each spell where known.

8 October 2026

Japan's B.League (B1 and B2): box scores and play by play are withdrawn; its games (date, teams, score) stay.
Korea's KBL: box scores, play by play and shots are withdrawn; its games (date, teams, score, venue) stay.
Players: GET /v1/players/{id} gains birth_date, height_cm, weight_kg and country (nationality as a three-letter IOC code) and position (PG, SG, SF, PF, C, G or F, or two joined such as G-F), each null where not known. More players are filled in each day.

2 October 2026

New: Brazil's NBB, game by game with full box scores, quarter scores, play by play with the running score, referees, coaches and arena. Seasons fill in over the coming days.
Spain's Liga Endesa, Copa del Rey and Supercopa: box scores are withdrawn; their games (date, teams, score) stay.
VTB United League: box scores, play by play and officials are withdrawn; its games (date, teams, score, venue, attendance) stay.
New: Lithuania's LKL, game by game with full box scores, team extras (points off turnovers, in the paint, second chance, fast break, bench, biggest lead and run, lead changes, ties, time leading), play by play with the running score, referees, coaches, arena and attendance. Seasons fill in over the coming days.
Games: every game now carries venue, the arena where the league names it (Greece's Basket League, Korea's KBL, Lithuania's LKL and Brazil's NBB; null elsewhere for now).
Games: GET /v1/games/{id} gains officials, the referees (crew chief first) and the commissioner, for VTB United League games where the league names them: nearly every game from 2018-19 on and in 2015-16, 2016-17 and 2009-10, and about a quarter of 2017-18. Other leagues follow as their game sheets allow; null where none are named.
New: GET /v1/players?q= finds players by name or team (on every plan, the free key included); /v1/players/{id}/seasons gives a player's averages in each season and team; /v1/teams/{id}/roster lists everyone who played for a team in a season; /v1/teams/{id}/head-to-head?opponent= gives two teams' record and last meetings, from Live; and /v1/stats/leaders?competition= ranks a season's leaders per game in points, rebounds, assists and six other figures, on Complete. The MCP server gains find_players.
Games: NBA play-in and play-off games now carry stage play-in and playoffs in every season (some were filed as regular season), so standings count the regular season alone. The NBA Cup final carries cup. Australia's NBL play-off games carry playoffs back to 1979-80, as do Japan's B1 and B2 championship games in most seasons from 2016-17 and Czechia's NBL play-offs in 1998-99.
Box scores: ABA League players whose names carry letters such as ş, ğ or ü are now in their team's box score (they were missing from some games), so team points match the final score in all but a handful of games.
Teams: 68 clubs held under two ids are joined, most of them a European club's cup games and its league games (CSKA Moscow, Žalgiris Kaunas, Unicaja, ALBA Berlin and others), so one team id now carries a club's whole history. An id merged away no longer answers: find the club again with GET /v1/teams?q=. US college names are written in full (Mississippi State, not Mississippi St.).
Competitions: the NBA's summer leagues (Las Vegas, Orlando, Salt Lake City) and the California Classic are filed as friendlies (kind friendly), so July exhibition games no longer count in NBA teams' form and splits unless you ask for that competition.
Games: 418 youth and junior games that had been filed under Spain's Liga Endesa are removed, so its tables and team records count league games alone.
Box scores added: Spain's Liga Endesa, Copa del Rey and Supercopa back to 2020-21 (2,477 games), and the ABA League back to 2001-02 (4,652 games). Korea's KBL is being filled back to 1997-98.
New from Live: GET /v1/standings?competition=, a season's table from its regular-season results, with played, won, lost, points for and against, home, away, last ten and streak. Leave season out for the latest. Ordered by share of games won, then points difference; a league's own tie-breakers are not applied.
Stats: /v1/teams/{id}/form, /v1/players/{id}/splits and /v1/stats/trends now count competitive games only. All-Star and pre-season games stay in the games list (with stage all-star or preseason) but are left out of the stats, and friendlies are left out unless you ask for that competition.
EuroCup now holds every season from 2002 as one competition; its 2002 to 2008 seasons were listed apart under the old name, ULEB Cup, which is retired.
Games: a new status, no_result, for a game with no score and none to come (called off, abandoned, decided by forfeit, postponed and not replayed, or never reported), so scheduled only ever means still to come and every game is scheduled, final or no_result. Filter with status=no_result.
New on Complete: the MCP server at https://basketballapi.net/mcp, 14 tools any assistant that speaks MCP can call with your key. See MCP.
Prices: each moneyline, spread and total market now carries opening and history, every reading before tip-off with the line most bookmakers showed and the average prices on it, for games from the 2026-27 season.
Ids now take their lasting form in lower case, such as gm_88km3vf9; upper case is still accepted.
A text parameter longer than 100 characters is answered with a 400.
Clubs that were listed twice are now one team, and games stored twice are now one game, so a club's history is all in one place.
New: webhooks for final scores, finished periods and closing prices, from the Live plan. See Webhooks.
New on Complete: GET /v1/teams/{id}/form (last games with pace, ratings and results against the closing lines), GET /v1/players/{id}/splits (home and away, by result, month, opponent or role) and GET /v1/stats/trends (betting angles with their hit rate and return).
New: GET /v1/games/{id}/prices, closing prices from every bookmaker for moneyline, spread, total, three-way and double chance, with each market's result. On Archive and Complete.
Box scores: team totals now always add up the players' lines and the team's own rebounds, and played is true for every player with minutes.
Shots: free throws now have value 1 and no position on the floor.
Play by play: the start and end of each period carry a clock, and the end of the game appears once.
Daily limits on every plan, shared by all the keys on an account.
The free key now reads box scores, players and player game logs for recent games.
Archive now reaches today's and upcoming games as well as every past season.

September 2026

v1 released: competitions, seasons, teams, games, box scores, play by play, shots, players and game logs, yesterday's results, usage and the OpenAPI description.