Basketball

NBA and KBL share schedules, identity, rosters, standings, live state, odds, box scores, matchup, and rotation reads. League-specific detail differs; NBA analytics must not be assumed available for KBL.

Game and roster workflow

Route below `/v1/{league}`	Behavior
`/games`, `/games/{id}`	Schedule, season/type, score, quarter lines, and available team totals.
`/games/{id}/live`	Normalized status/period and basketball live detail such as team fouls.
`/lineups/{id}`	Basketball starting lineup projection; separate from a rotation.
`/rotations/{id}`	Stored rotation detail.
`/games/{id}/box-score`	Player box-score rows; `/boxscore` is an alias.
`/games/{id}/matchup`	Composite matchup context.
`/teams/{id}/roster?season=2025-26`	Historical season roster when specified; current membership when omitted.
`/teams/{id}/recent?limit=10`	Recent games; default 10, maximum 30.

Canonical identity and current team membership can differ from the team a player represented in an earlier season. Use a season roster for historical lineups. Season labels can be normalized to a start year by supported readers; follow the individual parameter schema.

NBA analytics

Route below `/v1/nba`	Content
`/team-stats?season=`	Team season totals, rates, and advanced metrics; `data.season` and `data.teams`.
`/team-defense?season=`	Defensive projection of team season statistics.
`/team-dvp?season=&position=`	Defense versus position; `data.items` with season/position context.
`/team-playtypes?season=`	Team play-type performance.
`/shot-types?season=`	Shot-type aggregates.
`/players/{id}/tracking?season=`	Drives, touches, pull-up and catch-and-shoot blocks, games, and minutes.
`/season-leaders?season=&teamId=&limit=`	Player season aggregate leaders, optionally team-scoped.
`/games/{id}/play-by-play?limit=`	Ordered plays; default 1000, maximum 2000.
`/games/{id}/shot-chart?limit=`	Shot events/locations; default 500, maximum 2000.

DVP, tracking, and play-type data have separate source coverage and samples. Use their response fields rather than substituting team defense as a DVP value. Shot coordinates and classifications follow the returned provider projection; do not assume every league uses the same coordinate system.

KBL detail

KBL supports the shared /team-stats?season= endpoint. Its team season statistics are derived from player box scores, while NBA statistics are sourced from the NBA team-statistics feed. The leagues share the response shape; their source coverage differs. KBL adds /head-to-head?teamA=&teamB=&season=, /season-leaders?season=&teamId=&limit=, and /players/{id}/season-stats?season=. Player season stats include counting totals, per-game metrics, and shooting percentages when available. /games/{id}/play-by-play and /games/{id}/shot-chart use KBL-specific event projections. The NBA playtypes, shot-types, tracking, and DVP readers do not establish equivalent KBL coverage.

Injury reports

Request	Behavior
`/v1/nba/teams/{id}/injuries`	Current team injuries.
`/v1/nba/teams/{id}/injuries?date=YYYY-MM-DD`	Archived report for that team/date.
`/v1/nba/injuries?date=YYYY-MM-DD`	Archived league report in `data.items`; date is required. Without it, returns 404 `endpoint_not_for_sport`.
`/v1/kbl/injuries`, `/v1/kbl/teams/{id}/injuries`	200 availability response, rather than an injury feed. Optional `date` must be YYYY-MM-DD.

KBL’s response includes:

{
  "data": {
    "availability": "provider_unavailable",
    "reason": "dated_injury_feed_not_exposed",
    "source": "kbl_official",
    "report_date": "",
    "items": []
  }
}

Team-scoped KBL responses replace items with team_id and injuries. The empty collection does not claim that all players are healthy. Historical NBA reports also depend on archival coverage for the requested date.

Get Started

Core Concepts

Data & Integration

Agents

Game and roster workflow

NBA analytics

KBL detail

Injury reports

​Game and roster workflow

​NBA analytics

​KBL detail

​Injury reports

Game and roster workflow

NBA analytics

KBL detail

Injury reports