Season Stats & Analytics
A club's on-court units
KBL-only route. Every combination of group_quantity players (2–5)
the club had on court together, from the official text cast's
substitution events (the source SportQuanta's rotation derivation
reads): games, seconds, and both sides' counting stats while the unit
played, most time first. A game whose cast loses track of the five on
court, or does not add up to the final score, is left out
(games_complete counts the folded games).
Requires the stats entitlement (a paid plan). See Responses & Errors for the success envelope and availability rules.
https://api.sportquanta.com/v1/kbl/lineupsReference context: KBL.
Overview · Response conventions
Authorizations
AuthorizationstringheaderrequiredSend a workspace API token in the Authorization: Bearer <token> header.
Query Parameters
teamstringrequiredseasonintegerrequiredRequired range: 2000 <= x, x <= 2100
group_quantityintegerdefault:5Required range: 2 <= x, x <= 5
Response
application/jsonThe club's on-court units.
Query validation failed. Depending on the handler, invalid_query_parameter is returned with HTTP 400 or 422. Pre-read validation is non-billable.
Missing or invalid bearer API token.
Access is forbidden: the token lacks api.read scope, the plan lacks an endpoint/bookmaker capability, or configured billing access is inactive. Inspect error.code and details.feature when present.
The id is well-formed but no document has been ingested for it yet.
Query validation failed. Depending on the handler, invalid_query_parameter is returned with HTTP 400 or 422. Pre-read validation is non-billable.
Hourly rate ceiling or monthly quota exceeded. The error code disambiguates
which limit was hit. X-RateLimit-* and X-Requests-*-Month response headers
carry the current state of both counters.
Token validation or an internal handler failed. Token-store failures use api_token_lookup_failed; unsupported internal sport dispatch can use data_layer_unavailable.
The data layer (Mongo / ClickHouse / Redis cache) is temporarily unreachable. The server attempted the lookup; it failed. Retry with backoff. Per the spec's order of evaluation, this DOES consume monthly quota — the request reached step 6.
The configured billing provider could not verify API access. The request is refused before the data handler and does not consume monthly quota.
dataobjectrequireddata.team_idstringrequireddata.seasonintegerrequireddata.group_quantityintegerrequireddata.gamesintegerrequireddata.games_completeintegerrequireddata.secondsintegerrequireddata.itemsobject[]requireddata.items.player_idsstring[]requireddata.items.gamesintegerrequireddata.items.secondsintegerrequireddata.items.teamobjectrequireddata.items.team.pointsintegerrequireddata.items.team.fgmintegerrequireddata.items.team.fgaintegerrequireddata.items.team.fg2mintegerrequireddata.items.team.fg2aintegerrequireddata.items.team.fg3mintegerrequireddata.items.team.fg3aintegerrequireddata.items.team.ftmintegerrequireddata.items.team.ftaintegerrequireddata.items.team.orebintegerrequireddata.items.team.drebintegerrequireddata.items.team.tovintegerrequireddata.items.team.player_tovintegerrequireddata.items.team.team_tovintegerrequireddata.items.team.astintegerrequireddata.items.team.stlintegerrequireddata.items.team.blkintegerrequireddata.items.team.pfintegerrequireddata.items.opponentobjectrequireddata.items.opponent.pointsintegerrequireddata.items.opponent.fgmintegerrequireddata.items.opponent.fgaintegerrequireddata.items.opponent.fg2mintegerrequireddata.items.opponent.fg2aintegerrequireddata.items.opponent.fg3mintegerrequireddata.items.opponent.fg3aintegerrequireddata.items.opponent.ftmintegerrequireddata.items.opponent.ftaintegerrequireddata.items.opponent.orebintegerrequireddata.items.opponent.drebintegerrequireddata.items.opponent.tovintegerrequireddata.items.opponent.player_tovintegerrequireddata.items.opponent.team_tovintegerrequireddata.items.opponent.astintegerrequireddata.items.opponent.stlintegerrequireddata.items.opponent.blkintegerrequireddata.items.opponent.pfintegerrequireddata.items.game_idsstring[]required_metaobjectResponse request/cache metadata. Optional evidence fields are specific to this handler; cache TTL does not measure source-data freshness.
_meta.request_idstring_meta.served_fromenum<string>Available options: live, cache
_meta.cache_ttl_secondsintegerResponse cache TTL; independent of source freshness. Omitted when zero.
errorobjectrequirederror.codestringrequiredStable machine-readable error code.
error.messagestringrequiredUser-facing error summary.
error.detailsanyOptional error details.