{"openapi":"3.0.3","info":{"title":"Basketball API","version":"1.0.0","description":"Standings, schedules, results, live scores with the quarter and clock, full box scores, player and team season statistics and leaderboards for NBA and EuroLeague. Season-scoped endpoints accept `?season=2025-26` and default to the current season. Keys are issued through RapidAPI."},"components":{"securitySchemes":{"rapidApiKey":{"type":"apiKey","in":"header","name":"X-RapidAPI-Key","description":"Your RapidAPI application key"},"rapidApiHost":{"type":"apiKey","in":"header","name":"X-RapidAPI-Host","description":"Always basketball-leagues1.p.rapidapi.com"},"apiKey":{"type":"apiKey","in":"header","name":"X-Api-Key","description":"A key issued directly, for the origin server"}},"schemas":{}},"paths":{"/competitions":{"get":{"summary":"All competitions","tags":["competitions"],"description":"Every competition this API covers, with the seasons, tables and stages of each.","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"country":{"type":"string","nullable":true},"logoUrl":{"type":"string"},"currentSeason":{"type":"string","nullable":true},"seasons":{"type":"array","items":{"type":"string"}},"tables":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"name":{"type":"string"},"grouped":{"type":"boolean"}},"required":["key","name","grouped"],"additionalProperties":false},"description":"The tables `/standings?table=` accepts, the default first."},"stages":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"phase":{"type":"string","enum":["regular","playoffs"],"nullable":true}},"required":["slug","name","phase"],"additionalProperties":false}}},"required":["slug","name","country","logoUrl","currentSeason","seasons","tables","stages"],"additionalProperties":false}},"meta":{"type":"object","properties":{"season":{"type":"string"},"table":{"type":"string"},"phase":{"type":"string"},"page":{"type":"number"},"limit":{"type":"number"},"total":{"type":"number"}},"additionalProperties":false}},"required":["data","meta"],"additionalProperties":false}}}}}}},"/players/{id}":{"get":{"summary":"Player career","tags":["players"],"description":"A player across every competition, season and phase we hold.","parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"number"},"slug":{"type":"string","nullable":true},"name":{"type":"string"},"photoUrl":{"type":"string"},"shortName":{"type":"string","nullable":true},"position":{"type":"string","enum":["guard","forward","center"],"nullable":true},"detailedPosition":{"type":"string","enum":["PG","SG","SF","PF","C","G","F"],"nullable":true,"description":"Usual role: PG, SG, SF, PF or C."},"birthdate":{"type":"string","nullable":true},"age":{"type":"number","nullable":true},"height":{"type":"number","nullable":true,"description":"Centimetres."},"nationality":{"type":"object","properties":{"id":{"type":"number"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false,"nullable":true},"team":{"type":"object","properties":{"id":{"type":"number"},"slug":{"type":"string","nullable":true},"name":{"type":"string"},"shortName":{"type":"string","nullable":true},"code":{"type":"string","nullable":true,"description":"Three-letter abbreviation, e.g. BOS."},"logoUrl":{"type":"string"}},"required":["id","slug","name","shortName","code","logoUrl"],"additionalProperties":false,"nullable":true},"shirtNumber":{"type":"number","nullable":true},"career":{"type":"array","items":{"type":"object","properties":{"competition":{"type":"string"},"season":{"type":"string"},"stats":{"type":"object","properties":{"phase":{"type":"string","enum":["regular","playoffs"]},"team":{"type":"object","properties":{"id":{"type":"number"},"slug":{"type":"string","nullable":true},"name":{"type":"string"},"shortName":{"type":"string","nullable":true},"code":{"type":"string","nullable":true,"description":"Three-letter abbreviation, e.g. BOS."},"logoUrl":{"type":"string"}},"required":["id","slug","name","shortName","code","logoUrl"],"additionalProperties":false},"games":{"type":"number"},"starts":{"type":"number"},"minutes":{"type":"number","description":"Total minutes, to one decimal."},"totals":{"type":"object","properties":{"points":{"type":"number"},"rebounds":{"type":"number"},"offensiveRebounds":{"type":"number"},"defensiveRebounds":{"type":"number"},"assists":{"type":"number"},"steals":{"type":"number"},"blocks":{"type":"number"},"turnovers":{"type":"number"},"fouls":{"type":"number"},"fieldGoalsMade":{"type":"number"},"fieldGoalsAttempted":{"type":"number"},"threePointersMade":{"type":"number"},"threePointersAttempted":{"type":"number"},"freeThrowsMade":{"type":"number"},"freeThrowsAttempted":{"type":"number"},"plusMinus":{"type":"number","nullable":true}},"required":["points","rebounds","offensiveRebounds","defensiveRebounds","assists","steals","blocks","turnovers","fouls","fieldGoalsMade","fieldGoalsAttempted","threePointersMade","threePointersAttempted","freeThrowsMade","freeThrowsAttempted","plusMinus"],"additionalProperties":false},"perGame":{"type":"object","properties":{"minutes":{"type":"number"},"points":{"type":"number"},"rebounds":{"type":"number"},"offensiveRebounds":{"type":"number"},"defensiveRebounds":{"type":"number"},"assists":{"type":"number"},"steals":{"type":"number"},"blocks":{"type":"number"},"turnovers":{"type":"number"},"fouls":{"type":"number"},"threePointersMade":{"type":"number"},"plusMinus":{"type":"number","nullable":true}},"required":["minutes","points","rebounds","offensiveRebounds","defensiveRebounds","assists","steals","blocks","turnovers","fouls","threePointersMade","plusMinus"],"additionalProperties":false},"percentages":{"type":"object","properties":{"fieldGoal":{"type":"number","nullable":true},"threePoint":{"type":"number","nullable":true},"freeThrow":{"type":"number","nullable":true}},"required":["fieldGoal","threePoint","freeThrow"],"additionalProperties":false,"description":"Made over attempted, e.g. 0.481; null with no attempts."}},"required":["phase","team","games","starts","minutes","totals","perGame","percentages"],"additionalProperties":false}},"required":["competition","season","stats"],"additionalProperties":false}}},"required":["id","slug","name","photoUrl","shortName","position","detailedPosition","birthdate","age","height","nationality","team","shirtNumber","career"],"additionalProperties":false},"meta":{"type":"object","properties":{"season":{"type":"string"},"table":{"type":"string"},"phase":{"type":"string"},"page":{"type":"number"},"limit":{"type":"number"},"total":{"type":"number"}},"additionalProperties":false}},"required":["data","meta"],"additionalProperties":false}}}}}}},"/games/live":{"get":{"summary":"Live games","tags":["games"],"description":"Games in play right now in every competition, with the score, the quarter and the clock. Updated every 30 seconds.","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"competition":{"type":"string"},"season":{"type":"string"},"stage":{"type":"string","nullable":true,"description":"regular-season, play-in, first-round, conference-semifinals, ... `GET /` lists a competition's stages."},"gameNumber":{"type":"number","nullable":true},"tipoff":{"type":"string","format":"date-time"},"status":{"type":"string","enum":["scheduled","live","halftime","finished","postponed","cancelled"]},"period":{"type":"number","nullable":true,"description":"While in play: the quarter, 1 to 4, then 5 for the first overtime and so on."},"clock":{"type":"string","nullable":true,"description":"While in play: time left in the period, e.g. \"02:13\"."},"homeTeam":{"type":"object","properties":{"id":{"type":"number"},"slug":{"type":"string","nullable":true},"name":{"type":"string"},"shortName":{"type":"string","nullable":true},"code":{"type":"string","nullable":true,"description":"Three-letter abbreviation, e.g. BOS."},"logoUrl":{"type":"string"}},"required":["id","slug","name","shortName","code","logoUrl"],"additionalProperties":false},"awayTeam":{"type":"object","properties":{"id":{"type":"number"},"slug":{"type":"string","nullable":true},"name":{"type":"string"},"shortName":{"type":"string","nullable":true},"code":{"type":"string","nullable":true,"description":"Three-letter abbreviation, e.g. BOS."},"logoUrl":{"type":"string"}},"required":["id","slug","name","shortName","code","logoUrl"],"additionalProperties":false},"score":{"type":"object","properties":{"home":{"type":"number","nullable":true},"away":{"type":"number","nullable":true}},"required":["home","away"],"additionalProperties":false},"series":{"type":"object","properties":{"home":{"type":"number"},"away":{"type":"number"}},"required":["home","away"],"additionalProperties":false,"nullable":true,"description":"Games won in the series by each side, this one included. Null outside a playoff series."},"venue":{"type":"string","nullable":true}},"required":["id","competition","season","stage","gameNumber","tipoff","status","period","clock","homeTeam","awayTeam","score","series","venue"],"additionalProperties":false}},"meta":{"type":"object","properties":{"season":{"type":"string"},"table":{"type":"string"},"phase":{"type":"string"},"page":{"type":"number"},"limit":{"type":"number"},"total":{"type":"number"}},"additionalProperties":false}},"required":["data","meta"],"additionalProperties":false}}}}}}},"/search":{"get":{"summary":"Search","tags":["search"],"description":"Find teams and players by name across every competition.","parameters":[{"schema":{"type":"string","minLength":2,"maxLength":50},"in":"query","name":"q","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"teams":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"slug":{"type":"string","nullable":true},"name":{"type":"string"},"shortName":{"type":"string","nullable":true},"code":{"type":"string","nullable":true,"description":"Three-letter abbreviation, e.g. BOS."},"logoUrl":{"type":"string"}},"required":["id","slug","name","shortName","code","logoUrl"],"additionalProperties":false}},"players":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"slug":{"type":"string","nullable":true},"name":{"type":"string"},"photoUrl":{"type":"string"}},"required":["id","slug","name","photoUrl"],"additionalProperties":false}}},"required":["teams","players"],"additionalProperties":false},"meta":{"type":"object","properties":{"season":{"type":"string"},"table":{"type":"string"},"phase":{"type":"string"},"page":{"type":"number"},"limit":{"type":"number"},"total":{"type":"number"}},"additionalProperties":false}},"required":["data","meta"],"additionalProperties":false}}}}}}},"/{competition}/":{"get":{"summary":"Competition overview","tags":["competition"],"description":"Slug, name, country, logo, the seasons available, the tables `/standings` serves and the stages games are filed under.","parameters":[{"schema":{"type":"string"},"in":"path","name":"competition","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"country":{"type":"string","nullable":true},"logoUrl":{"type":"string"},"currentSeason":{"type":"string","nullable":true},"seasons":{"type":"array","items":{"type":"string"}},"tables":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"name":{"type":"string"},"grouped":{"type":"boolean"}},"required":["key","name","grouped"],"additionalProperties":false},"description":"The tables `/standings?table=` accepts, the default first."},"stages":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"phase":{"type":"string","enum":["regular","playoffs"],"nullable":true}},"required":["slug","name","phase"],"additionalProperties":false}}},"required":["slug","name","country","logoUrl","currentSeason","seasons","tables","stages"],"additionalProperties":false},"meta":{"type":"object","properties":{"season":{"type":"string"},"table":{"type":"string"},"phase":{"type":"string"},"page":{"type":"number"},"limit":{"type":"number"},"total":{"type":"number"}},"additionalProperties":false}},"required":["data","meta"],"additionalProperties":false}}}}}}},"/{competition}/standings":{"get":{"summary":"Standings","tags":["standings"],"description":"The regular-season table: won, lost, win percentage, games behind, points for and against, home and away records, the last ten and the current streak. The NBA has `conference` (the default), `division` and `league` tables, ranked within each group; the EuroLeague one. Ordered by win percentage and the competition's tie-breaks.","parameters":[{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}$"},"in":"query","name":"season","required":false,"description":"Season label, e.g. 2025-26. Defaults to the current season."},{"schema":{"type":"string"},"in":"query","name":"table","required":false,"description":"`conference`, `division` or `league` in the NBA. `GET /` lists them."},{"schema":{"type":"string"},"in":"path","name":"competition","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"position":{"type":"number","description":"Within the group, when the table has groups."},"group":{"type":"string","nullable":true,"description":"The conference or division the row is ranked in; null for a single table."},"team":{"type":"object","properties":{"id":{"type":"number"},"slug":{"type":"string","nullable":true},"name":{"type":"string"},"shortName":{"type":"string","nullable":true},"code":{"type":"string","nullable":true,"description":"Three-letter abbreviation, e.g. BOS."},"logoUrl":{"type":"string"}},"required":["id","slug","name","shortName","code","logoUrl"],"additionalProperties":false},"played":{"type":"number"},"won":{"type":"number"},"lost":{"type":"number"},"winPct":{"type":"number","description":"Wins divided by games played, e.g. 0.732."},"gamesBehind":{"type":"number","description":"Games behind the leader of the group; 0 for the leader."},"pointsFor":{"type":"number"},"pointsAgainst":{"type":"number"},"pointDiff":{"type":"number"},"home":{"type":"object","properties":{"won":{"type":"number"},"lost":{"type":"number"}},"required":["won","lost"],"additionalProperties":false},"away":{"type":"object","properties":{"won":{"type":"number"},"lost":{"type":"number"}},"required":["won","lost"],"additionalProperties":false},"lastTen":{"type":"object","properties":{"won":{"type":"number"},"lost":{"type":"number"}},"required":["won","lost"],"additionalProperties":false},"form":{"type":"string","description":"Up to the last ten results, oldest first, e.g. \"WWLWWLWWWL\"."},"streak":{"type":"string","description":"The current run, e.g. \"W3\"; empty before the first game."},"zone":{"type":"string","enum":["playoffs","play-in"],"nullable":true,"description":"playoffs or play-in for the positions that lead there; null otherwise."}},"required":["position","group","team","played","won","lost","winPct","gamesBehind","pointsFor","pointsAgainst","pointDiff","home","away","lastTen","form","streak","zone"],"additionalProperties":false}},"meta":{"type":"object","properties":{"season":{"type":"string"},"table":{"type":"string"},"phase":{"type":"string"},"page":{"type":"number"},"limit":{"type":"number"},"total":{"type":"number"}},"additionalProperties":false}},"required":["data","meta"],"additionalProperties":false}}}}}}},"/{competition}/teams":{"get":{"summary":"Teams in a season","tags":["teams"],"description":"Every team in the regular season, with names, colours, country and head coach.","parameters":[{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}$"},"in":"query","name":"season","required":false,"description":"Season label, e.g. 2025-26. Defaults to the current season."},{"schema":{"type":"string"},"in":"path","name":"competition","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"slug":{"type":"string","nullable":true},"name":{"type":"string"},"shortName":{"type":"string","nullable":true},"code":{"type":"string","nullable":true,"description":"Three-letter abbreviation, e.g. BOS."},"logoUrl":{"type":"string"},"longName":{"type":"string","nullable":true},"country":{"type":"object","properties":{"id":{"type":"number"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false,"nullable":true},"colors":{"type":"object","properties":{"home":{"type":"string","nullable":true},"away":{"type":"string","nullable":true}},"required":["home","away"],"additionalProperties":false},"coach":{"type":"string","nullable":true}},"required":["id","slug","name","shortName","code","logoUrl","longName","country","colors","coach"],"additionalProperties":false}},"meta":{"type":"object","properties":{"season":{"type":"string"},"table":{"type":"string"},"phase":{"type":"string"},"page":{"type":"number"},"limit":{"type":"number"},"total":{"type":"number"}},"additionalProperties":false}},"required":["data","meta"],"additionalProperties":false}}}}}}},"/{competition}/teams/{id}":{"get":{"summary":"One team","tags":["teams"],"description":"A team by numeric id or slug, e.g. `boston-celtics`.","parameters":[{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}$"},"in":"query","name":"season","required":false,"description":"Season label, e.g. 2025-26. Defaults to the current season."},{"schema":{"type":"string"},"in":"path","name":"competition","required":true},{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"number"},"slug":{"type":"string","nullable":true},"name":{"type":"string"},"shortName":{"type":"string","nullable":true},"code":{"type":"string","nullable":true,"description":"Three-letter abbreviation, e.g. BOS."},"logoUrl":{"type":"string"},"longName":{"type":"string","nullable":true},"country":{"type":"object","properties":{"id":{"type":"number"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false,"nullable":true},"colors":{"type":"object","properties":{"home":{"type":"string","nullable":true},"away":{"type":"string","nullable":true}},"required":["home","away"],"additionalProperties":false},"coach":{"type":"string","nullable":true}},"required":["id","slug","name","shortName","code","logoUrl","longName","country","colors","coach"],"additionalProperties":false},"meta":{"type":"object","properties":{"season":{"type":"string"},"table":{"type":"string"},"phase":{"type":"string"},"page":{"type":"number"},"limit":{"type":"number"},"total":{"type":"number"}},"additionalProperties":false}},"required":["data","meta"],"additionalProperties":false}}}}}}},"/{competition}/teams/{id}/roster":{"get":{"summary":"Roster","tags":["teams"],"description":"The roster with shirt numbers, positions, height, age and nationality.","parameters":[{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}$"},"in":"query","name":"season","required":false,"description":"Season label, e.g. 2025-26. Defaults to the current season."},{"schema":{"type":"string"},"in":"path","name":"competition","required":true},{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"slug":{"type":"string","nullable":true},"name":{"type":"string"},"photoUrl":{"type":"string"},"shortName":{"type":"string","nullable":true},"position":{"type":"string","enum":["guard","forward","center"],"nullable":true},"detailedPosition":{"type":"string","enum":["PG","SG","SF","PF","C","G","F"],"nullable":true,"description":"Usual role: PG, SG, SF, PF or C."},"birthdate":{"type":"string","nullable":true},"age":{"type":"number","nullable":true},"height":{"type":"number","nullable":true,"description":"Centimetres."},"nationality":{"type":"object","properties":{"id":{"type":"number"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false,"nullable":true},"team":{"type":"object","properties":{"id":{"type":"number"},"slug":{"type":"string","nullable":true},"name":{"type":"string"},"shortName":{"type":"string","nullable":true},"code":{"type":"string","nullable":true,"description":"Three-letter abbreviation, e.g. BOS."},"logoUrl":{"type":"string"}},"required":["id","slug","name","shortName","code","logoUrl"],"additionalProperties":false,"nullable":true},"shirtNumber":{"type":"number","nullable":true}},"required":["id","slug","name","photoUrl","shortName","position","detailedPosition","birthdate","age","height","nationality","team","shirtNumber"],"additionalProperties":false}},"meta":{"type":"object","properties":{"season":{"type":"string"},"table":{"type":"string"},"phase":{"type":"string"},"page":{"type":"number"},"limit":{"type":"number"},"total":{"type":"number"}},"additionalProperties":false}},"required":["data","meta"],"additionalProperties":false}}}}}}},"/{competition}/teams/{id}/games":{"get":{"summary":"A team's games","tags":["teams"],"description":"Schedule and results for one team, filterable by status.","parameters":[{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}$"},"in":"query","name":"season","required":false,"description":"Season label, e.g. 2025-26. Defaults to the current season."},{"schema":{"type":"string","enum":["scheduled","live","halftime","finished","postponed","cancelled"]},"in":"query","name":"status","required":false},{"schema":{"type":"string"},"in":"path","name":"competition","required":true},{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"competition":{"type":"string"},"season":{"type":"string"},"stage":{"type":"string","nullable":true,"description":"regular-season, play-in, first-round, conference-semifinals, ... `GET /` lists a competition's stages."},"gameNumber":{"type":"number","nullable":true},"tipoff":{"type":"string","format":"date-time"},"status":{"type":"string","enum":["scheduled","live","halftime","finished","postponed","cancelled"]},"period":{"type":"number","nullable":true,"description":"While in play: the quarter, 1 to 4, then 5 for the first overtime and so on."},"clock":{"type":"string","nullable":true,"description":"While in play: time left in the period, e.g. \"02:13\"."},"homeTeam":{"type":"object","properties":{"id":{"type":"number"},"slug":{"type":"string","nullable":true},"name":{"type":"string"},"shortName":{"type":"string","nullable":true},"code":{"type":"string","nullable":true,"description":"Three-letter abbreviation, e.g. BOS."},"logoUrl":{"type":"string"}},"required":["id","slug","name","shortName","code","logoUrl"],"additionalProperties":false},"awayTeam":{"type":"object","properties":{"id":{"type":"number"},"slug":{"type":"string","nullable":true},"name":{"type":"string"},"shortName":{"type":"string","nullable":true},"code":{"type":"string","nullable":true,"description":"Three-letter abbreviation, e.g. BOS."},"logoUrl":{"type":"string"}},"required":["id","slug","name","shortName","code","logoUrl"],"additionalProperties":false},"score":{"type":"object","properties":{"home":{"type":"number","nullable":true},"away":{"type":"number","nullable":true}},"required":["home","away"],"additionalProperties":false},"series":{"type":"object","properties":{"home":{"type":"number"},"away":{"type":"number"}},"required":["home","away"],"additionalProperties":false,"nullable":true,"description":"Games won in the series by each side, this one included. Null outside a playoff series."},"venue":{"type":"string","nullable":true}},"required":["id","competition","season","stage","gameNumber","tipoff","status","period","clock","homeTeam","awayTeam","score","series","venue"],"additionalProperties":false}},"meta":{"type":"object","properties":{"season":{"type":"string"},"table":{"type":"string"},"phase":{"type":"string"},"page":{"type":"number"},"limit":{"type":"number"},"total":{"type":"number"}},"additionalProperties":false}},"required":["data","meta"],"additionalProperties":false}}}}}}},"/{competition}/teams/{id}/stats":{"get":{"summary":"Team season statistics","tags":["teams"],"description":"Won, lost, points for and against, box-score totals, per-game averages and shooting percentages, for the regular season or the playoffs.","parameters":[{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}$"},"in":"query","name":"season","required":false,"description":"Season label, e.g. 2025-26. Defaults to the current season."},{"schema":{"type":"string","enum":["regular","playoffs"],"default":"regular"},"in":"query","name":"phase","required":false,"description":"`regular` for the regular season (the default), `playoffs` for the playoffs. Preseason and play-in games count in neither."},{"schema":{"type":"string"},"in":"path","name":"competition","required":true},{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"phase":{"type":"string","enum":["regular","playoffs"]},"games":{"type":"number"},"won":{"type":"number"},"lost":{"type":"number"},"pointsFor":{"type":"number"},"pointsAgainst":{"type":"number"},"totals":{"type":"object","properties":{"points":{"type":"number"},"rebounds":{"type":"number"},"offensiveRebounds":{"type":"number"},"defensiveRebounds":{"type":"number"},"assists":{"type":"number"},"steals":{"type":"number"},"blocks":{"type":"number"},"turnovers":{"type":"number"},"fouls":{"type":"number"},"fieldGoalsMade":{"type":"number"},"fieldGoalsAttempted":{"type":"number"},"threePointersMade":{"type":"number"},"threePointersAttempted":{"type":"number"},"freeThrowsMade":{"type":"number"},"freeThrowsAttempted":{"type":"number"}},"required":["points","rebounds","offensiveRebounds","defensiveRebounds","assists","steals","blocks","turnovers","fouls","fieldGoalsMade","fieldGoalsAttempted","threePointersMade","threePointersAttempted","freeThrowsMade","freeThrowsAttempted"],"additionalProperties":false},"perGame":{"type":"object","properties":{"points":{"type":"number"},"pointsAgainst":{"type":"number"},"rebounds":{"type":"number"},"assists":{"type":"number"},"steals":{"type":"number"},"blocks":{"type":"number"},"turnovers":{"type":"number"},"threePointersMade":{"type":"number"}},"required":["points","pointsAgainst","rebounds","assists","steals","blocks","turnovers","threePointersMade"],"additionalProperties":false},"percentages":{"type":"object","properties":{"fieldGoal":{"type":"number","nullable":true},"threePoint":{"type":"number","nullable":true},"freeThrow":{"type":"number","nullable":true}},"required":["fieldGoal","threePoint","freeThrow"],"additionalProperties":false}},"required":["phase","games","won","lost","pointsFor","pointsAgainst","totals","perGame","percentages"],"additionalProperties":false},"meta":{"type":"object","properties":{"season":{"type":"string"},"table":{"type":"string"},"phase":{"type":"string"},"page":{"type":"number"},"limit":{"type":"number"},"total":{"type":"number"}},"additionalProperties":false}},"required":["data","meta"],"additionalProperties":false}}}}}}},"/{competition}/teams/{id}/head-to-head/{otherId}":{"get":{"summary":"Head to head","tags":["teams"],"description":"Every stored meeting between two teams, across seasons, with wins and points on each side.","parameters":[{"schema":{"type":"string"},"in":"path","name":"competition","required":true},{"schema":{"type":"string"},"in":"path","name":"id","required":true},{"schema":{"type":"string"},"in":"path","name":"otherId","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"teams":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"slug":{"type":"string","nullable":true},"name":{"type":"string"},"shortName":{"type":"string","nullable":true},"code":{"type":"string","nullable":true,"description":"Three-letter abbreviation, e.g. BOS."},"logoUrl":{"type":"string"}},"required":["id","slug","name","shortName","code","logoUrl"],"additionalProperties":false},"minItems":2,"maxItems":2,"description":"The two teams, in the order given in the path"},"summary":{"type":"object","properties":{"games":{"type":"number"},"wins":{"type":"array","items":{"type":"number"},"minItems":2,"maxItems":2,"description":"Wins for each team, same order as teams"},"points":{"type":"array","items":{"type":"number"},"minItems":2,"maxItems":2,"description":"Points scored by each team, same order as teams"}},"required":["games","wins","points"],"additionalProperties":false},"games":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"competition":{"type":"string"},"season":{"type":"string"},"stage":{"type":"string","nullable":true,"description":"regular-season, play-in, first-round, conference-semifinals, ... `GET /` lists a competition's stages."},"gameNumber":{"type":"number","nullable":true},"tipoff":{"type":"string","format":"date-time"},"status":{"type":"string","enum":["scheduled","live","halftime","finished","postponed","cancelled"]},"period":{"type":"number","nullable":true,"description":"While in play: the quarter, 1 to 4, then 5 for the first overtime and so on."},"clock":{"type":"string","nullable":true,"description":"While in play: time left in the period, e.g. \"02:13\"."},"homeTeam":{"type":"object","properties":{"id":{"type":"number"},"slug":{"type":"string","nullable":true},"name":{"type":"string"},"shortName":{"type":"string","nullable":true},"code":{"type":"string","nullable":true,"description":"Three-letter abbreviation, e.g. BOS."},"logoUrl":{"type":"string"}},"required":["id","slug","name","shortName","code","logoUrl"],"additionalProperties":false},"awayTeam":{"type":"object","properties":{"id":{"type":"number"},"slug":{"type":"string","nullable":true},"name":{"type":"string"},"shortName":{"type":"string","nullable":true},"code":{"type":"string","nullable":true,"description":"Three-letter abbreviation, e.g. BOS."},"logoUrl":{"type":"string"}},"required":["id","slug","name","shortName","code","logoUrl"],"additionalProperties":false},"score":{"type":"object","properties":{"home":{"type":"number","nullable":true},"away":{"type":"number","nullable":true}},"required":["home","away"],"additionalProperties":false},"series":{"type":"object","properties":{"home":{"type":"number"},"away":{"type":"number"}},"required":["home","away"],"additionalProperties":false,"nullable":true,"description":"Games won in the series by each side, this one included. Null outside a playoff series."},"venue":{"type":"string","nullable":true}},"required":["id","competition","season","stage","gameNumber","tipoff","status","period","clock","homeTeam","awayTeam","score","series","venue"],"additionalProperties":false}}},"required":["teams","summary","games"],"additionalProperties":false},"meta":{"type":"object","properties":{"season":{"type":"string"},"table":{"type":"string"},"phase":{"type":"string"},"page":{"type":"number"},"limit":{"type":"number"},"total":{"type":"number"}},"additionalProperties":false}},"required":["data","meta"],"additionalProperties":false}}}}}}},"/{competition}/players":{"get":{"summary":"Players in a season","tags":["players"],"description":"Players on a roster this season, filterable by team and position.","parameters":[{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}$"},"in":"query","name":"season","required":false,"description":"Season label, e.g. 2025-26. Defaults to the current season."},{"schema":{"type":"string"},"in":"query","name":"team","required":false},{"schema":{"type":"string","enum":["guard","forward","center"]},"in":"query","name":"position","required":false},{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false},{"schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"path","name":"competition","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"slug":{"type":"string","nullable":true},"name":{"type":"string"},"photoUrl":{"type":"string"},"shortName":{"type":"string","nullable":true},"position":{"type":"string","enum":["guard","forward","center"],"nullable":true},"detailedPosition":{"type":"string","enum":["PG","SG","SF","PF","C","G","F"],"nullable":true,"description":"Usual role: PG, SG, SF, PF or C."},"birthdate":{"type":"string","nullable":true},"age":{"type":"number","nullable":true},"height":{"type":"number","nullable":true,"description":"Centimetres."},"nationality":{"type":"object","properties":{"id":{"type":"number"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false,"nullable":true},"team":{"type":"object","properties":{"id":{"type":"number"},"slug":{"type":"string","nullable":true},"name":{"type":"string"},"shortName":{"type":"string","nullable":true},"code":{"type":"string","nullable":true,"description":"Three-letter abbreviation, e.g. BOS."},"logoUrl":{"type":"string"}},"required":["id","slug","name","shortName","code","logoUrl"],"additionalProperties":false,"nullable":true},"shirtNumber":{"type":"number","nullable":true}},"required":["id","slug","name","photoUrl","shortName","position","detailedPosition","birthdate","age","height","nationality","team","shirtNumber"],"additionalProperties":false}},"meta":{"type":"object","properties":{"season":{"type":"string"},"table":{"type":"string"},"phase":{"type":"string"},"page":{"type":"number"},"limit":{"type":"number"},"total":{"type":"number"}},"additionalProperties":false}},"required":["data","meta"],"additionalProperties":false}}}}}}},"/{competition}/players/{id}":{"get":{"summary":"Player","tags":["players"],"description":"A player with season totals, per-game averages and shooting percentages, one entry per team they played for.","parameters":[{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}$"},"in":"query","name":"season","required":false,"description":"Season label, e.g. 2025-26. Defaults to the current season."},{"schema":{"type":"string","enum":["regular","playoffs"],"default":"regular"},"in":"query","name":"phase","required":false,"description":"`regular` for the regular season (the default), `playoffs` for the playoffs. Preseason and play-in games count in neither."},{"schema":{"type":"string"},"in":"path","name":"competition","required":true},{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"number"},"slug":{"type":"string","nullable":true},"name":{"type":"string"},"photoUrl":{"type":"string"},"shortName":{"type":"string","nullable":true},"position":{"type":"string","enum":["guard","forward","center"],"nullable":true},"detailedPosition":{"type":"string","enum":["PG","SG","SF","PF","C","G","F"],"nullable":true,"description":"Usual role: PG, SG, SF, PF or C."},"birthdate":{"type":"string","nullable":true},"age":{"type":"number","nullable":true},"height":{"type":"number","nullable":true,"description":"Centimetres."},"nationality":{"type":"object","properties":{"id":{"type":"number"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false,"nullable":true},"team":{"type":"object","properties":{"id":{"type":"number"},"slug":{"type":"string","nullable":true},"name":{"type":"string"},"shortName":{"type":"string","nullable":true},"code":{"type":"string","nullable":true,"description":"Three-letter abbreviation, e.g. BOS."},"logoUrl":{"type":"string"}},"required":["id","slug","name","shortName","code","logoUrl"],"additionalProperties":false,"nullable":true},"shirtNumber":{"type":"number","nullable":true},"stats":{"type":"array","items":{"type":"object","properties":{"phase":{"type":"string","enum":["regular","playoffs"]},"team":{"type":"object","properties":{"id":{"type":"number"},"slug":{"type":"string","nullable":true},"name":{"type":"string"},"shortName":{"type":"string","nullable":true},"code":{"type":"string","nullable":true,"description":"Three-letter abbreviation, e.g. BOS."},"logoUrl":{"type":"string"}},"required":["id","slug","name","shortName","code","logoUrl"],"additionalProperties":false},"games":{"type":"number"},"starts":{"type":"number"},"minutes":{"type":"number","description":"Total minutes, to one decimal."},"totals":{"type":"object","properties":{"points":{"type":"number"},"rebounds":{"type":"number"},"offensiveRebounds":{"type":"number"},"defensiveRebounds":{"type":"number"},"assists":{"type":"number"},"steals":{"type":"number"},"blocks":{"type":"number"},"turnovers":{"type":"number"},"fouls":{"type":"number"},"fieldGoalsMade":{"type":"number"},"fieldGoalsAttempted":{"type":"number"},"threePointersMade":{"type":"number"},"threePointersAttempted":{"type":"number"},"freeThrowsMade":{"type":"number"},"freeThrowsAttempted":{"type":"number"},"plusMinus":{"type":"number","nullable":true}},"required":["points","rebounds","offensiveRebounds","defensiveRebounds","assists","steals","blocks","turnovers","fouls","fieldGoalsMade","fieldGoalsAttempted","threePointersMade","threePointersAttempted","freeThrowsMade","freeThrowsAttempted","plusMinus"],"additionalProperties":false},"perGame":{"type":"object","properties":{"minutes":{"type":"number"},"points":{"type":"number"},"rebounds":{"type":"number"},"offensiveRebounds":{"type":"number"},"defensiveRebounds":{"type":"number"},"assists":{"type":"number"},"steals":{"type":"number"},"blocks":{"type":"number"},"turnovers":{"type":"number"},"fouls":{"type":"number"},"threePointersMade":{"type":"number"},"plusMinus":{"type":"number","nullable":true}},"required":["minutes","points","rebounds","offensiveRebounds","defensiveRebounds","assists","steals","blocks","turnovers","fouls","threePointersMade","plusMinus"],"additionalProperties":false},"percentages":{"type":"object","properties":{"fieldGoal":{"type":"number","nullable":true},"threePoint":{"type":"number","nullable":true},"freeThrow":{"type":"number","nullable":true}},"required":["fieldGoal","threePoint","freeThrow"],"additionalProperties":false,"description":"Made over attempted, e.g. 0.481; null with no attempts."}},"required":["phase","team","games","starts","minutes","totals","perGame","percentages"],"additionalProperties":false},"description":"One entry per team the player played for in the season and phase; traded players have several."}},"required":["id","slug","name","photoUrl","shortName","position","detailedPosition","birthdate","age","height","nationality","team","shirtNumber","stats"],"additionalProperties":false},"meta":{"type":"object","properties":{"season":{"type":"string"},"table":{"type":"string"},"phase":{"type":"string"},"page":{"type":"number"},"limit":{"type":"number"},"total":{"type":"number"}},"additionalProperties":false}},"required":["data","meta"],"additionalProperties":false}}}}}}},"/{competition}/players/{id}/games":{"get":{"summary":"Game log","tags":["players"],"description":"Every game a player was listed for this season, with their full box-score line.","parameters":[{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}$"},"in":"query","name":"season","required":false,"description":"Season label, e.g. 2025-26. Defaults to the current season."},{"schema":{"type":"string"},"in":"path","name":"competition","required":true},{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"shirtNumber":{"type":"number","nullable":true},"position":{"type":"string","enum":["PG","SG","SF","PF","C","G","F"],"nullable":true,"description":"PG, SG, SF, PF or C, or G and F where only the group is known."},"played":{"type":"boolean","description":"False for a player who stayed on the bench; every figure is then 0."},"minutes":{"type":"string","description":"Time on the floor as the box score prints it, \"32:03\"."},"seconds":{"type":"number"},"points":{"type":"number"},"rebounds":{"type":"number"},"offensiveRebounds":{"type":"number"},"defensiveRebounds":{"type":"number"},"assists":{"type":"number"},"steals":{"type":"number"},"blocks":{"type":"number"},"turnovers":{"type":"number"},"fouls":{"type":"number"},"fieldGoalsMade":{"type":"number"},"fieldGoalsAttempted":{"type":"number"},"threePointersMade":{"type":"number"},"threePointersAttempted":{"type":"number"},"freeThrowsMade":{"type":"number"},"freeThrowsAttempted":{"type":"number"},"plusMinus":{"type":"number","nullable":true,"description":"Null where the competition does not keep it (the EuroLeague)."},"game":{"type":"object","properties":{"id":{"type":"number"},"competition":{"type":"string"},"season":{"type":"string"},"stage":{"type":"string","nullable":true,"description":"regular-season, play-in, first-round, conference-semifinals, ... `GET /` lists a competition's stages."},"gameNumber":{"type":"number","nullable":true},"tipoff":{"type":"string","format":"date-time"},"status":{"type":"string","enum":["scheduled","live","halftime","finished","postponed","cancelled"]},"period":{"type":"number","nullable":true,"description":"While in play: the quarter, 1 to 4, then 5 for the first overtime and so on."},"clock":{"type":"string","nullable":true,"description":"While in play: time left in the period, e.g. \"02:13\"."},"homeTeam":{"type":"object","properties":{"id":{"type":"number"},"slug":{"type":"string","nullable":true},"name":{"type":"string"},"shortName":{"type":"string","nullable":true},"code":{"type":"string","nullable":true,"description":"Three-letter abbreviation, e.g. BOS."},"logoUrl":{"type":"string"}},"required":["id","slug","name","shortName","code","logoUrl"],"additionalProperties":false},"awayTeam":{"type":"object","properties":{"id":{"type":"number"},"slug":{"type":"string","nullable":true},"name":{"type":"string"},"shortName":{"type":"string","nullable":true},"code":{"type":"string","nullable":true,"description":"Three-letter abbreviation, e.g. BOS."},"logoUrl":{"type":"string"}},"required":["id","slug","name","shortName","code","logoUrl"],"additionalProperties":false},"score":{"type":"object","properties":{"home":{"type":"number","nullable":true},"away":{"type":"number","nullable":true}},"required":["home","away"],"additionalProperties":false},"series":{"type":"object","properties":{"home":{"type":"number"},"away":{"type":"number"}},"required":["home","away"],"additionalProperties":false,"nullable":true,"description":"Games won in the series by each side, this one included. Null outside a playoff series."},"venue":{"type":"string","nullable":true}},"required":["id","competition","season","stage","gameNumber","tipoff","status","period","clock","homeTeam","awayTeam","score","series","venue"],"additionalProperties":false},"team":{"type":"object","properties":{"id":{"type":"number"},"slug":{"type":"string","nullable":true},"name":{"type":"string"},"shortName":{"type":"string","nullable":true},"code":{"type":"string","nullable":true,"description":"Three-letter abbreviation, e.g. BOS."},"logoUrl":{"type":"string"}},"required":["id","slug","name","shortName","code","logoUrl"],"additionalProperties":false},"starter":{"type":"boolean"}},"required":["shirtNumber","position","played","minutes","seconds","points","rebounds","offensiveRebounds","defensiveRebounds","assists","steals","blocks","turnovers","fouls","fieldGoalsMade","fieldGoalsAttempted","threePointersMade","threePointersAttempted","freeThrowsMade","freeThrowsAttempted","plusMinus","game","team","starter"],"additionalProperties":false}},"meta":{"type":"object","properties":{"season":{"type":"string"},"table":{"type":"string"},"phase":{"type":"string"},"page":{"type":"number"},"limit":{"type":"number"},"total":{"type":"number"}},"additionalProperties":false}},"required":["data","meta"],"additionalProperties":false}}}}}}},"/{competition}/games":{"get":{"summary":"Schedule and results","tags":["games"],"description":"Games for a season, filterable by date, date range, status, team and stage, with pagination.","parameters":[{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}$"},"in":"query","name":"season","required":false,"description":"Season label, e.g. 2025-26. Defaults to the current season."},{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"in":"query","name":"date","required":false},{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"in":"query","name":"from","required":false},{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"in":"query","name":"to","required":false},{"schema":{"type":"string","enum":["scheduled","live","halftime","finished","postponed","cancelled"]},"in":"query","name":"status","required":false},{"schema":{"type":"string"},"in":"query","name":"team","required":false},{"schema":{"type":"string"},"in":"query","name":"stage","required":false,"description":"regular-season, play-in, first-round, ... `GET /` lists them."},{"schema":{"type":"integer","minimum":1,"default":1},"in":"query","name":"page","required":false},{"schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"path","name":"competition","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"competition":{"type":"string"},"season":{"type":"string"},"stage":{"type":"string","nullable":true,"description":"regular-season, play-in, first-round, conference-semifinals, ... `GET /` lists a competition's stages."},"gameNumber":{"type":"number","nullable":true},"tipoff":{"type":"string","format":"date-time"},"status":{"type":"string","enum":["scheduled","live","halftime","finished","postponed","cancelled"]},"period":{"type":"number","nullable":true,"description":"While in play: the quarter, 1 to 4, then 5 for the first overtime and so on."},"clock":{"type":"string","nullable":true,"description":"While in play: time left in the period, e.g. \"02:13\"."},"homeTeam":{"type":"object","properties":{"id":{"type":"number"},"slug":{"type":"string","nullable":true},"name":{"type":"string"},"shortName":{"type":"string","nullable":true},"code":{"type":"string","nullable":true,"description":"Three-letter abbreviation, e.g. BOS."},"logoUrl":{"type":"string"}},"required":["id","slug","name","shortName","code","logoUrl"],"additionalProperties":false},"awayTeam":{"type":"object","properties":{"id":{"type":"number"},"slug":{"type":"string","nullable":true},"name":{"type":"string"},"shortName":{"type":"string","nullable":true},"code":{"type":"string","nullable":true,"description":"Three-letter abbreviation, e.g. BOS."},"logoUrl":{"type":"string"}},"required":["id","slug","name","shortName","code","logoUrl"],"additionalProperties":false},"score":{"type":"object","properties":{"home":{"type":"number","nullable":true},"away":{"type":"number","nullable":true}},"required":["home","away"],"additionalProperties":false},"series":{"type":"object","properties":{"home":{"type":"number"},"away":{"type":"number"}},"required":["home","away"],"additionalProperties":false,"nullable":true,"description":"Games won in the series by each side, this one included. Null outside a playoff series."},"venue":{"type":"string","nullable":true}},"required":["id","competition","season","stage","gameNumber","tipoff","status","period","clock","homeTeam","awayTeam","score","series","venue"],"additionalProperties":false}},"meta":{"type":"object","properties":{"season":{"type":"string"},"table":{"type":"string"},"phase":{"type":"string"},"page":{"type":"number"},"limit":{"type":"number"},"total":{"type":"number"}},"additionalProperties":false}},"required":["data","meta"],"additionalProperties":false}}}}}}},"/{competition}/games/live":{"get":{"summary":"Live games","tags":["games"],"description":"Games in play right now, with the score, the quarter and the clock. Updated every 30 seconds.","parameters":[{"schema":{"type":"string"},"in":"path","name":"competition","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"competition":{"type":"string"},"season":{"type":"string"},"stage":{"type":"string","nullable":true,"description":"regular-season, play-in, first-round, conference-semifinals, ... `GET /` lists a competition's stages."},"gameNumber":{"type":"number","nullable":true},"tipoff":{"type":"string","format":"date-time"},"status":{"type":"string","enum":["scheduled","live","halftime","finished","postponed","cancelled"]},"period":{"type":"number","nullable":true,"description":"While in play: the quarter, 1 to 4, then 5 for the first overtime and so on."},"clock":{"type":"string","nullable":true,"description":"While in play: time left in the period, e.g. \"02:13\"."},"homeTeam":{"type":"object","properties":{"id":{"type":"number"},"slug":{"type":"string","nullable":true},"name":{"type":"string"},"shortName":{"type":"string","nullable":true},"code":{"type":"string","nullable":true,"description":"Three-letter abbreviation, e.g. BOS."},"logoUrl":{"type":"string"}},"required":["id","slug","name","shortName","code","logoUrl"],"additionalProperties":false},"awayTeam":{"type":"object","properties":{"id":{"type":"number"},"slug":{"type":"string","nullable":true},"name":{"type":"string"},"shortName":{"type":"string","nullable":true},"code":{"type":"string","nullable":true,"description":"Three-letter abbreviation, e.g. BOS."},"logoUrl":{"type":"string"}},"required":["id","slug","name","shortName","code","logoUrl"],"additionalProperties":false},"score":{"type":"object","properties":{"home":{"type":"number","nullable":true},"away":{"type":"number","nullable":true}},"required":["home","away"],"additionalProperties":false},"series":{"type":"object","properties":{"home":{"type":"number"},"away":{"type":"number"}},"required":["home","away"],"additionalProperties":false,"nullable":true,"description":"Games won in the series by each side, this one included. Null outside a playoff series."},"venue":{"type":"string","nullable":true}},"required":["id","competition","season","stage","gameNumber","tipoff","status","period","clock","homeTeam","awayTeam","score","series","venue"],"additionalProperties":false}},"meta":{"type":"object","properties":{"season":{"type":"string"},"table":{"type":"string"},"phase":{"type":"string"},"page":{"type":"number"},"limit":{"type":"number"},"total":{"type":"number"}},"additionalProperties":false}},"required":["data","meta"],"additionalProperties":false}}}}}}},"/{competition}/games/today":{"get":{"summary":"Today's games","tags":["games"],"description":"Every game tipping off today (UTC), whatever its status.","parameters":[{"schema":{"type":"string"},"in":"path","name":"competition","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"competition":{"type":"string"},"season":{"type":"string"},"stage":{"type":"string","nullable":true,"description":"regular-season, play-in, first-round, conference-semifinals, ... `GET /` lists a competition's stages."},"gameNumber":{"type":"number","nullable":true},"tipoff":{"type":"string","format":"date-time"},"status":{"type":"string","enum":["scheduled","live","halftime","finished","postponed","cancelled"]},"period":{"type":"number","nullable":true,"description":"While in play: the quarter, 1 to 4, then 5 for the first overtime and so on."},"clock":{"type":"string","nullable":true,"description":"While in play: time left in the period, e.g. \"02:13\"."},"homeTeam":{"type":"object","properties":{"id":{"type":"number"},"slug":{"type":"string","nullable":true},"name":{"type":"string"},"shortName":{"type":"string","nullable":true},"code":{"type":"string","nullable":true,"description":"Three-letter abbreviation, e.g. BOS."},"logoUrl":{"type":"string"}},"required":["id","slug","name","shortName","code","logoUrl"],"additionalProperties":false},"awayTeam":{"type":"object","properties":{"id":{"type":"number"},"slug":{"type":"string","nullable":true},"name":{"type":"string"},"shortName":{"type":"string","nullable":true},"code":{"type":"string","nullable":true,"description":"Three-letter abbreviation, e.g. BOS."},"logoUrl":{"type":"string"}},"required":["id","slug","name","shortName","code","logoUrl"],"additionalProperties":false},"score":{"type":"object","properties":{"home":{"type":"number","nullable":true},"away":{"type":"number","nullable":true}},"required":["home","away"],"additionalProperties":false},"series":{"type":"object","properties":{"home":{"type":"number"},"away":{"type":"number"}},"required":["home","away"],"additionalProperties":false,"nullable":true,"description":"Games won in the series by each side, this one included. Null outside a playoff series."},"venue":{"type":"string","nullable":true}},"required":["id","competition","season","stage","gameNumber","tipoff","status","period","clock","homeTeam","awayTeam","score","series","venue"],"additionalProperties":false}},"meta":{"type":"object","properties":{"season":{"type":"string"},"table":{"type":"string"},"phase":{"type":"string"},"page":{"type":"number"},"limit":{"type":"number"},"total":{"type":"number"}},"additionalProperties":false}},"required":["data","meta"],"additionalProperties":false}}}}}}},"/{competition}/games/next":{"get":{"summary":"Next games","tags":["games"],"description":"Every game on the next day (UTC) with one still to be played.","parameters":[{"schema":{"type":"string"},"in":"path","name":"competition","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"competition":{"type":"string"},"season":{"type":"string"},"stage":{"type":"string","nullable":true,"description":"regular-season, play-in, first-round, conference-semifinals, ... `GET /` lists a competition's stages."},"gameNumber":{"type":"number","nullable":true},"tipoff":{"type":"string","format":"date-time"},"status":{"type":"string","enum":["scheduled","live","halftime","finished","postponed","cancelled"]},"period":{"type":"number","nullable":true,"description":"While in play: the quarter, 1 to 4, then 5 for the first overtime and so on."},"clock":{"type":"string","nullable":true,"description":"While in play: time left in the period, e.g. \"02:13\"."},"homeTeam":{"type":"object","properties":{"id":{"type":"number"},"slug":{"type":"string","nullable":true},"name":{"type":"string"},"shortName":{"type":"string","nullable":true},"code":{"type":"string","nullable":true,"description":"Three-letter abbreviation, e.g. BOS."},"logoUrl":{"type":"string"}},"required":["id","slug","name","shortName","code","logoUrl"],"additionalProperties":false},"awayTeam":{"type":"object","properties":{"id":{"type":"number"},"slug":{"type":"string","nullable":true},"name":{"type":"string"},"shortName":{"type":"string","nullable":true},"code":{"type":"string","nullable":true,"description":"Three-letter abbreviation, e.g. BOS."},"logoUrl":{"type":"string"}},"required":["id","slug","name","shortName","code","logoUrl"],"additionalProperties":false},"score":{"type":"object","properties":{"home":{"type":"number","nullable":true},"away":{"type":"number","nullable":true}},"required":["home","away"],"additionalProperties":false},"series":{"type":"object","properties":{"home":{"type":"number"},"away":{"type":"number"}},"required":["home","away"],"additionalProperties":false,"nullable":true,"description":"Games won in the series by each side, this one included. Null outside a playoff series."},"venue":{"type":"string","nullable":true}},"required":["id","competition","season","stage","gameNumber","tipoff","status","period","clock","homeTeam","awayTeam","score","series","venue"],"additionalProperties":false}},"meta":{"type":"object","properties":{"season":{"type":"string"},"table":{"type":"string"},"phase":{"type":"string"},"page":{"type":"number"},"limit":{"type":"number"},"total":{"type":"number"}},"additionalProperties":false}},"required":["data","meta"],"additionalProperties":false}}}}}}},"/{competition}/games/{id}":{"get":{"summary":"Box score","tags":["games"],"description":"One game in full: score, status, quarter and clock, the score by quarter, attendance, and both box scores with every player line and team totals.","parameters":[{"schema":{"type":"string"},"in":"path","name":"competition","required":true},{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"number"},"competition":{"type":"string"},"season":{"type":"string"},"stage":{"type":"string","nullable":true,"description":"regular-season, play-in, first-round, conference-semifinals, ... `GET /` lists a competition's stages."},"gameNumber":{"type":"number","nullable":true},"tipoff":{"type":"string","format":"date-time"},"status":{"type":"string","enum":["scheduled","live","halftime","finished","postponed","cancelled"]},"period":{"type":"number","nullable":true,"description":"While in play: the quarter, 1 to 4, then 5 for the first overtime and so on."},"clock":{"type":"string","nullable":true,"description":"While in play: time left in the period, e.g. \"02:13\"."},"homeTeam":{"type":"object","properties":{"id":{"type":"number"},"slug":{"type":"string","nullable":true},"name":{"type":"string"},"shortName":{"type":"string","nullable":true},"code":{"type":"string","nullable":true,"description":"Three-letter abbreviation, e.g. BOS."},"logoUrl":{"type":"string"}},"required":["id","slug","name","shortName","code","logoUrl"],"additionalProperties":false},"awayTeam":{"type":"object","properties":{"id":{"type":"number"},"slug":{"type":"string","nullable":true},"name":{"type":"string"},"shortName":{"type":"string","nullable":true},"code":{"type":"string","nullable":true,"description":"Three-letter abbreviation, e.g. BOS."},"logoUrl":{"type":"string"}},"required":["id","slug","name","shortName","code","logoUrl"],"additionalProperties":false},"score":{"type":"object","properties":{"home":{"type":"number","nullable":true},"away":{"type":"number","nullable":true}},"required":["home","away"],"additionalProperties":false},"series":{"type":"object","properties":{"home":{"type":"number"},"away":{"type":"number"}},"required":["home","away"],"additionalProperties":false,"nullable":true,"description":"Games won in the series by each side, this one included. Null outside a playoff series."},"venue":{"type":"string","nullable":true},"periods":{"type":"array","items":{"type":"object","properties":{"period":{"type":"string","description":"Q1 to Q4, then OT, OT2, ..."},"home":{"type":"number"},"away":{"type":"number"}},"required":["period","home","away"],"additionalProperties":false}},"attendance":{"type":"number","nullable":true},"boxScore":{"type":"object","properties":{"home":{"type":"object","properties":{"starters":{"type":"array","items":{"type":"object","properties":{"player":{"type":"object","properties":{"id":{"type":"number"},"slug":{"type":"string","nullable":true},"name":{"type":"string"},"photoUrl":{"type":"string"}},"required":["id","slug","name","photoUrl"],"additionalProperties":false},"shirtNumber":{"type":"number","nullable":true},"position":{"type":"string","enum":["PG","SG","SF","PF","C","G","F"],"nullable":true,"description":"PG, SG, SF, PF or C, or G and F where only the group is known."},"played":{"type":"boolean","description":"False for a player who stayed on the bench; every figure is then 0."},"minutes":{"type":"string","description":"Time on the floor as the box score prints it, \"32:03\"."},"seconds":{"type":"number"},"points":{"type":"number"},"rebounds":{"type":"number"},"offensiveRebounds":{"type":"number"},"defensiveRebounds":{"type":"number"},"assists":{"type":"number"},"steals":{"type":"number"},"blocks":{"type":"number"},"turnovers":{"type":"number"},"fouls":{"type":"number"},"fieldGoalsMade":{"type":"number"},"fieldGoalsAttempted":{"type":"number"},"threePointersMade":{"type":"number"},"threePointersAttempted":{"type":"number"},"freeThrowsMade":{"type":"number"},"freeThrowsAttempted":{"type":"number"},"plusMinus":{"type":"number","nullable":true,"description":"Null where the competition does not keep it (the EuroLeague)."}},"required":["player","shirtNumber","position","played","minutes","seconds","points","rebounds","offensiveRebounds","defensiveRebounds","assists","steals","blocks","turnovers","fouls","fieldGoalsMade","fieldGoalsAttempted","threePointersMade","threePointersAttempted","freeThrowsMade","freeThrowsAttempted","plusMinus"],"additionalProperties":false}},"bench":{"type":"array","items":{"type":"object","properties":{"player":{"type":"object","properties":{"id":{"type":"number"},"slug":{"type":"string","nullable":true},"name":{"type":"string"},"photoUrl":{"type":"string"}},"required":["id","slug","name","photoUrl"],"additionalProperties":false},"shirtNumber":{"type":"number","nullable":true},"position":{"type":"string","enum":["PG","SG","SF","PF","C","G","F"],"nullable":true,"description":"PG, SG, SF, PF or C, or G and F where only the group is known."},"played":{"type":"boolean","description":"False for a player who stayed on the bench; every figure is then 0."},"minutes":{"type":"string","description":"Time on the floor as the box score prints it, \"32:03\"."},"seconds":{"type":"number"},"points":{"type":"number"},"rebounds":{"type":"number"},"offensiveRebounds":{"type":"number"},"defensiveRebounds":{"type":"number"},"assists":{"type":"number"},"steals":{"type":"number"},"blocks":{"type":"number"},"turnovers":{"type":"number"},"fouls":{"type":"number"},"fieldGoalsMade":{"type":"number"},"fieldGoalsAttempted":{"type":"number"},"threePointersMade":{"type":"number"},"threePointersAttempted":{"type":"number"},"freeThrowsMade":{"type":"number"},"freeThrowsAttempted":{"type":"number"},"plusMinus":{"type":"number","nullable":true,"description":"Null where the competition does not keep it (the EuroLeague)."}},"required":["player","shirtNumber","position","played","minutes","seconds","points","rebounds","offensiveRebounds","defensiveRebounds","assists","steals","blocks","turnovers","fouls","fieldGoalsMade","fieldGoalsAttempted","threePointersMade","threePointersAttempted","freeThrowsMade","freeThrowsAttempted","plusMinus"],"additionalProperties":false}},"totals":{"type":"object","properties":{"points":{"type":"number"},"rebounds":{"type":"number"},"offensiveRebounds":{"type":"number"},"defensiveRebounds":{"type":"number"},"assists":{"type":"number"},"steals":{"type":"number"},"blocks":{"type":"number"},"turnovers":{"type":"number"},"fouls":{"type":"number"},"fieldGoalsMade":{"type":"number"},"fieldGoalsAttempted":{"type":"number"},"threePointersMade":{"type":"number"},"threePointersAttempted":{"type":"number"},"freeThrowsMade":{"type":"number"},"freeThrowsAttempted":{"type":"number"}},"required":["points","rebounds","offensiveRebounds","defensiveRebounds","assists","steals","blocks","turnovers","fouls","fieldGoalsMade","fieldGoalsAttempted","threePointersMade","threePointersAttempted","freeThrowsMade","freeThrowsAttempted"],"additionalProperties":false}},"required":["starters","bench","totals"],"additionalProperties":false},"away":{"type":"object","properties":{"starters":{"type":"array","items":{"type":"object","properties":{"player":{"type":"object","properties":{"id":{"type":"number"},"slug":{"type":"string","nullable":true},"name":{"type":"string"},"photoUrl":{"type":"string"}},"required":["id","slug","name","photoUrl"],"additionalProperties":false},"shirtNumber":{"type":"number","nullable":true},"position":{"type":"string","enum":["PG","SG","SF","PF","C","G","F"],"nullable":true,"description":"PG, SG, SF, PF or C, or G and F where only the group is known."},"played":{"type":"boolean","description":"False for a player who stayed on the bench; every figure is then 0."},"minutes":{"type":"string","description":"Time on the floor as the box score prints it, \"32:03\"."},"seconds":{"type":"number"},"points":{"type":"number"},"rebounds":{"type":"number"},"offensiveRebounds":{"type":"number"},"defensiveRebounds":{"type":"number"},"assists":{"type":"number"},"steals":{"type":"number"},"blocks":{"type":"number"},"turnovers":{"type":"number"},"fouls":{"type":"number"},"fieldGoalsMade":{"type":"number"},"fieldGoalsAttempted":{"type":"number"},"threePointersMade":{"type":"number"},"threePointersAttempted":{"type":"number"},"freeThrowsMade":{"type":"number"},"freeThrowsAttempted":{"type":"number"},"plusMinus":{"type":"number","nullable":true,"description":"Null where the competition does not keep it (the EuroLeague)."}},"required":["player","shirtNumber","position","played","minutes","seconds","points","rebounds","offensiveRebounds","defensiveRebounds","assists","steals","blocks","turnovers","fouls","fieldGoalsMade","fieldGoalsAttempted","threePointersMade","threePointersAttempted","freeThrowsMade","freeThrowsAttempted","plusMinus"],"additionalProperties":false}},"bench":{"type":"array","items":{"type":"object","properties":{"player":{"type":"object","properties":{"id":{"type":"number"},"slug":{"type":"string","nullable":true},"name":{"type":"string"},"photoUrl":{"type":"string"}},"required":["id","slug","name","photoUrl"],"additionalProperties":false},"shirtNumber":{"type":"number","nullable":true},"position":{"type":"string","enum":["PG","SG","SF","PF","C","G","F"],"nullable":true,"description":"PG, SG, SF, PF or C, or G and F where only the group is known."},"played":{"type":"boolean","description":"False for a player who stayed on the bench; every figure is then 0."},"minutes":{"type":"string","description":"Time on the floor as the box score prints it, \"32:03\"."},"seconds":{"type":"number"},"points":{"type":"number"},"rebounds":{"type":"number"},"offensiveRebounds":{"type":"number"},"defensiveRebounds":{"type":"number"},"assists":{"type":"number"},"steals":{"type":"number"},"blocks":{"type":"number"},"turnovers":{"type":"number"},"fouls":{"type":"number"},"fieldGoalsMade":{"type":"number"},"fieldGoalsAttempted":{"type":"number"},"threePointersMade":{"type":"number"},"threePointersAttempted":{"type":"number"},"freeThrowsMade":{"type":"number"},"freeThrowsAttempted":{"type":"number"},"plusMinus":{"type":"number","nullable":true,"description":"Null where the competition does not keep it (the EuroLeague)."}},"required":["player","shirtNumber","position","played","minutes","seconds","points","rebounds","offensiveRebounds","defensiveRebounds","assists","steals","blocks","turnovers","fouls","fieldGoalsMade","fieldGoalsAttempted","threePointersMade","threePointersAttempted","freeThrowsMade","freeThrowsAttempted","plusMinus"],"additionalProperties":false}},"totals":{"type":"object","properties":{"points":{"type":"number"},"rebounds":{"type":"number"},"offensiveRebounds":{"type":"number"},"defensiveRebounds":{"type":"number"},"assists":{"type":"number"},"steals":{"type":"number"},"blocks":{"type":"number"},"turnovers":{"type":"number"},"fouls":{"type":"number"},"fieldGoalsMade":{"type":"number"},"fieldGoalsAttempted":{"type":"number"},"threePointersMade":{"type":"number"},"threePointersAttempted":{"type":"number"},"freeThrowsMade":{"type":"number"},"freeThrowsAttempted":{"type":"number"}},"required":["points","rebounds","offensiveRebounds","defensiveRebounds","assists","steals","blocks","turnovers","fouls","fieldGoalsMade","fieldGoalsAttempted","threePointersMade","threePointersAttempted","freeThrowsMade","freeThrowsAttempted"],"additionalProperties":false}},"required":["starters","bench","totals"],"additionalProperties":false}},"required":["home","away"],"additionalProperties":false,"nullable":true,"description":"Null until the game has a box score, which it has from tip-off on."}},"required":["id","competition","season","stage","gameNumber","tipoff","status","period","clock","homeTeam","awayTeam","score","series","venue","periods","attendance","boxScore"],"additionalProperties":false},"meta":{"type":"object","properties":{"season":{"type":"string"},"table":{"type":"string"},"phase":{"type":"string"},"page":{"type":"number"},"limit":{"type":"number"},"total":{"type":"number"}},"additionalProperties":false}},"required":["data","meta"],"additionalProperties":false}}}}}}},"/{competition}/leaders/{stat}":{"get":{"summary":"Season leaders","tags":["leaders"],"description":"Players ranked by a per-game average or a shooting percentage over the season, every team they played for added together. To qualify a player needs half as many games as the most anyone has played; percentages also need attempts, on average three field goals, one three-pointer or one free throw a qualifying game.","parameters":[{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}$"},"in":"query","name":"season","required":false,"description":"Season label, e.g. 2025-26. Defaults to the current season."},{"schema":{"type":"string","enum":["regular","playoffs"],"default":"regular"},"in":"query","name":"phase","required":false,"description":"`regular` for the regular season (the default), `playoffs` for the playoffs. Preseason and play-in games count in neither."},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"path","name":"competition","required":true},{"schema":{"type":"string","enum":["points","rebounds","assists","steals","blocks","three-pointers","minutes","field-goal-pct","three-point-pct","free-throw-pct"]},"in":"path","name":"stat","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"number"},"player":{"type":"object","properties":{"id":{"type":"number"},"slug":{"type":"string","nullable":true},"name":{"type":"string"},"photoUrl":{"type":"string"}},"required":["id","slug","name","photoUrl"],"additionalProperties":false},"team":{"type":"object","properties":{"id":{"type":"number"},"slug":{"type":"string","nullable":true},"name":{"type":"string"},"shortName":{"type":"string","nullable":true},"code":{"type":"string","nullable":true,"description":"Three-letter abbreviation, e.g. BOS."},"logoUrl":{"type":"string"}},"required":["id","slug","name","shortName","code","logoUrl"],"additionalProperties":false},"value":{"type":"number"},"games":{"type":"number"}},"required":["rank","player","team","value","games"],"additionalProperties":false}},"meta":{"type":"object","properties":{"season":{"type":"string"},"table":{"type":"string"},"phase":{"type":"string"},"page":{"type":"number"},"limit":{"type":"number"},"total":{"type":"number"}},"additionalProperties":false}},"required":["data","meta"],"additionalProperties":false}}}}}}}},"servers":[{"url":"https://basketball-leagues1.p.rapidapi.com","description":"RapidAPI, every competition"},{"url":"/v1","description":"Origin, for keys issued directly"}],"security":[{"rapidApiKey":[],"rapidApiHost":[]},{"apiKey":[]}]}