Get a soccer player leaderboard
Soccer-only. Ranks a counting stat over the completed matches of
the league’s default competition (the most-covered one, resolved
per request). Rankable measures: goals, assists,
goal_contributions, yellow_cards, red_cards, cards.
A league with no loaded competition, or a measure that cannot be
ranked, answers 200 with { "available": false, "reason": ... }
rather than an error, so a consumer’s sync lane survives a cold
league. An empty board is a normal result with rows: [].
Returns 404 endpoint_not_for_sport when called against a
baseball or basketball league.
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
goals, assists, goal_contributions, yellow_cards, red_cards, cards Season label (e.g. 2024/25). Also steers which competition resolves.
1 <= x <= 50Response
Ranked leaderboard rows, or the honest-empty availability envelope.