Documentation / Seasons
Standings
GET /v1/seasons/{season_id}/standingsFree key and upMCP tool: get_standings
The regular season table built from the results: games, wins, losses, overtime and shootout results, goals and points. The free key reads current seasons.
GET
https://api.icehockeyapi.com/v1/seasons/{season_id}/standingshttps://api.icehockeyapi.com/v1/seasons/ss_0n4zhhna/standingscurl "https://api.icehockeyapi.com/v1/seasons/ss_0n4zhhna/standings" \ -H "X-API-Key: YOUR_KEY"
200 OKExample answer from the data, 12 Oct
{
"data": [
{
"position": 1,
"team": {
"id": "tm_24hh7x72",
"name": "Carolina Hurricanes",
"short_name": "CAR",
"country": "North America"
},
"games": 7,
"wins": 5,
"losses": 2,
"ties": 0,
"overtime_wins": 1,
"overtime_losses": 1,
"shootout_wins": 0,
"shootout_losses": 0,
"goals_for": 27,
"goals_against": 17,
"points": 11,
"goal_difference": 10
},
{
"position": 2,
"team": {
"id": "tm_kpzj338v",
"name": "New York Rangers",
"short_name": "NYR",
"country": "North America"
},
"games": 7,
"wins": 5,
"losses": 2,
"ties": 0,
"overtime_wins": 0,
"overtime_losses": 0,
"shootout_wins": 0,
"shootout_losses": 0,
"goals_for": 23,
"goals_against": 13,
"points": 10,
"goal_difference": 10
},
{
"position": 3,
"team": {
"id": "tm_7m42g3ej",
"name": "Vegas Golden Knights",
"short_name": "VGK",
"country": "North America"
},
"games": 6,
"wins": 5,
"losses": 1,
"ties": 0,
"overtime_wins": 1,
"overtime_losses": 0,
"shootout_wins": 1,
"shootout_losses": 0,
"goals_for": 23,
"goals_against": 14,
"points": 10,
"goal_difference": 9
}
],
"meta": {
"count": 32,
"season_id": "ss_0n4zhhna",
"points_rule": "2-1-0",
"note": "Built from the results; a league that used its own rules for a season may differ from its official table.",
"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. |
Returns
| Field | Type |
|---|---|
position | int |
team | object |
team.id | string |
team.name | string |
team.short_name | string |
team.country | string |
games | int |
wins | int |
losses | int |
ties | int |
overtime_wins | int |
overtime_losses | int |
shootout_wins | int |
shootout_losses | int |
goals_for | int |
goals_against | int |
points | int |
goal_difference | int |