Lineups & Box Scores
Starting lineup
Requires stats access. Baseball returns the stored game lineup; basketball returns a starting-lineup projection. This differs from the baseball lineup-card cascade and basketball rotation detail. Other sports return endpoint_not_for_sport.
https://api.sportquanta.com/v1/{league}/lineups/{id}Reference context: WKBL.
Overview · Response conventions
Authorizations
AuthorizationstringheaderrequiredSend a workspace API token in the Authorization: Bearer <token> header.
Path Parameters
leagueenum<string>default:wkblrequiredLeague for this reference section: wkbl.
Available options: wkbl
idstringrequiredQuery Parameters
provenancebooleandefault:falseOpt in to per-field provenance on supported single game, match, team, player, and venue reads. Lists and composites accept the flag but generally omit provenance. It is returned under _meta.provenance only when source metadata exists.
Response
application/jsonLineup document.
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.
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.idstringdata.canonical_idstringdata.external_idsobjectMap from the exact stored source/namespace key to that provider's identifier for this entity. Keys vary by entity and league. Values are strings, even when the provider ID looks numeric. Use the exact key and value for external-ID lookups; these are distinct from the canonical ID. SOURCE_KEY below is an illustrative placeholder.
data.external_ids.{key}stringdata.created_atstring<date-time>Canonical document creation timestamp, when present; not the scheduled start or event time.
data.updated_atstring<date-time>Canonical document update timestamp, when present. It is not a guarantee that every field was refreshed at this time; field provenance carries individual ingestion times.
data.game_idstringrequireddata.schedule_datestringrequireddata.homeobjectdata.home.team_idstringdata.home.statusstringdata.home.startersobject[] | nullrequireddata.home.starters.player_idstringrequireddata.home.starters.positionstringdata.home.starters.statusstringrequireddata.home.inactive_player_idsstring[] | nullrequireddata.home.provider_updated_atstringdata.awayobjectdata.away.team_idstringdata.away.statusstringdata.away.startersobject[] | nullrequireddata.away.starters.player_idstringrequireddata.away.starters.positionstringdata.away.starters.statusstringrequireddata.away.inactive_player_idsstring[] | nullrequireddata.away.provider_updated_atstring_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.
_meta.provenanceobjectMap keyed by canonical source field name. Each value identifies the winning source, ingestion run, and ingestion timestamp for that field. Keys can use the stored camelCase field name even when the response uses snake_case.
_meta.provenance.{key}object_meta.provenance.{key}.sourcestring_meta.provenance.{key}.run_idstring_meta.provenance.{key}.ingested_atstring<date-time>errorobjectrequirederror.codestringrequiredStable machine-readable error code.
error.messagestringrequiredUser-facing error summary.
error.detailsanyOptional error details.