Get a match's pitch layout and player cards (soccer only)
Returns the enriched lineup — formation rows the pitch graphic is drawn from, plus
a card behind each shirt carrying shirt number, nationality, height, age, market
value, rating, captain and goalkeeper markers, and that player’s own incidents —
read from the per-league match_lineup_detail collection.
Separate from /matches/{id}/lineup, which serves the canonical lineup entity.
That entity is assembled from several sources and is a list of names; it models no
formation at all. The two coexist rather than one superseding the other.
Incident kinds are the source’s GraphQL typenames, carried verbatim so a kind we have not catalogued still arrives with its minute and player.
Each shirt carries player_id, our canonical id resolved (never minted) from the
provider’s, so a client can localize the name and link through to the player. It is
null for a player the identity map does not know.
Lineups are posted about an hour before kickoff, so an earlier fixture returns 404.
Soccer-only — other sports return 404 endpoint_not_for_sport.
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.
Response
Per-match enriched lineup response (sides, home then away).