Get a team's roster
Universal across baseball, basketball, soccer, football, and
hockey. Returns the sport-specific player records currently
attached to the team (currentTeamId), as filled by the
roster ingestion (24h cadence) and, for soccer, the
squad-membership reconciler. NFL rows carry the football
position cluster (QB/RB/WR/…), depth-chart slot, and draft
metadata; NHL rows carry the hockey position cluster
(C/LW/RW/D/G), shoots/catches handedness, and contract bits.
active defaults to true; set active=false to include
retired or released players still tagged with the team. Reads
are soft — a team whose roster has not been ingested yet
returns an empty array rather than 404.
Authorizations
Send a workspace API token in the Authorization: Bearer <token> header.
Path Parameters
League identifier from the /v1/leagues catalog (e.g. mlb, nba,
epl, nfl, nhl). Unknown values return 404 unsupported_league.
Query Parameters
When true, the response envelope includes per-field provenance
metadata under _meta.provenance (source adapter, ingest run id,
timestamp). Default: omitted.
Response
Array of sport-specific player records.