Documentation / Seasons
Leaders
GET /v1/seasons/{season_id}/leadersLive and upMCP tool: season_leaders
The regular season leaders in points, goals, assists, plus-minus, penalty minutes or shots, for leagues with game detail.
GET
https://api.icehockeyapi.com/v1/seasons/{season_id}/leadershttps://api.icehockeyapi.com/v1/seasons/ss_0n4zhhna/leaderscurl "https://api.icehockeyapi.com/v1/seasons/ss_0n4zhhna/leaders" \ -H "X-API-Key: YOUR_KEY"
200 OKExample answer from the data, 12 Oct
{
"data": [
{
"rank": 1,
"player": {
"id": "pl_ass089c0",
"name": "Connor McDavid"
},
"games": 5,
"goals": 3,
"assists": 10,
"points": 13,
"plus_minus": 12,
"penalty_minutes": 0,
"shots": 12
},
{
"rank": 2,
"player": {
"id": "pl_dmfjbx5w",
"name": "Evan Bouchard"
},
"games": 5,
"goals": 6,
"assists": 6,
"points": 12,
"plus_minus": 12,
"penalty_minutes": 0,
"shots": 17
},
{
"rank": 3,
"player": {
"id": "pl_gxtgwh9s",
"name": "Jack Eichel"
},
"games": 6,
"goals": 3,
"assists": 9,
"points": 12,
"plus_minus": 5,
"penalty_minutes": 2,
"shots": 18
}
],
"meta": {
"count": 20,
"category": "points",
"season_id": "ss_0n4zhhna",
"plan": "Complete"
}
}Run works once the API is live; the code above works now.
Parameters
| Name | In | Type | What it does |
|---|---|---|---|
season_id required | path | id | A season, from /v1/leagues/{league_id}/seasons. |
category | query | enum | What to rank by: points (default) pointsgoalsassistsplus_minuspenalty_minutesshots |
limit | query | int | How many players: 20 (default) up to 100 |
Returns
| Field | Type |
|---|---|
rank | int |
player | object |
player.id | string |
player.name | string |
games | int |
goals | int |
assists | int |
points | int |
plus_minus | int |
penalty_minutes | int |
shots | int |