GET
Get a team's roster
Reference context: Catalog & Access. Overview · Response conventions

Authorizations

Authorization
string
header
required

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

Path Parameters

league
string
required

League identifier from the /v1/leagues catalog (e.g. mlb, nba, epl, nfl, nhl). Unknown values return 404 unsupported_league.

id
string
required

Query Parameters

active
boolean
default:true
provenance
boolean
default: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.

season
string

Basketball only: season start year or label such as 2025-26. Historical roster uses that season; omitted selects current roster.

Response

Array of sport-specific player records.

data
object
required
_meta
object