GET
Get a soccer player leaderboard

Authorizations

Authorization
string
header
default:tok_public_demo
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.

Query Parameters

measure
enum<string>
default:goals
Available options:
goals,
assists,
goal_contributions,
yellow_cards,
red_cards,
cards
season
string

Season label (e.g. 2024/25). Also steers which competition resolves.

limit
integer
default:20
Required range: 1 <= x <= 50

Response

Ranked leaderboard rows, or the honest-empty availability envelope.