Skip to content

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.

GEThttps://api.sportquanta.com/v1/{league}/lineups/{id}
GETGet a baseball lineup card or a basketball pregame starting lineup
GET/v1/{league}/lineups/{id}

Get a baseball lineup card or a basketball pregame 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.

Authorization
Path
Query
Get a baseball lineup card or a basketball pregame starting lineupcURL
200Example

Reference context: WKBL.

Overview · Response conventions

Authorizations

Authorizationstringheaderrequired

Send a workspace API token in the Authorization: Bearer <token> header.

Path Parameters

leagueenum<string>default:wkblrequired

League for this reference section: wkbl.

Available options: wkbl

idstringrequired

Query Parameters

provenancebooleandefault:false

Opt 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/json

Lineup document.

dataobjectrequired
data.idstring
data.canonical_idstring
data.external_idsobject

Map 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}string
data.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_idstringrequired
data.schedule_datestringrequired
data.homeobject
data.home.team_idstring
data.home.statusstring
data.home.startersobject[] | nullrequired
data.home.starters.player_idstringrequired
data.home.starters.positionstring
data.home.starters.statusstringrequired
data.home.inactive_player_idsstring[] | nullrequired
data.home.provider_updated_atstring
data.awayobject
data.away.team_idstring
data.away.statusstring
data.away.startersobject[] | nullrequired
data.away.starters.player_idstringrequired
data.away.starters.positionstring
data.away.starters.statusstringrequired
data.away.inactive_player_idsstring[] | nullrequired
data.away.provider_updated_atstring
_metaobject

Response 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_secondsinteger

Response cache TTL; independent of source freshness. Omitted when zero.

_meta.provenanceobject

Map 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>