Standings

This endpoint allows you to retrieve the standings. For the type argument you can search by: home, away and total.

Multi-language: This feature allows the user to manually change the language of the API response by adding value to the lang attribute. Example: lang=en.

Pagination: The endpoint uses an offset and limit system. Specify the offset and limit parameters to fetch the desired range of results. The maximum and default number of results per request is 50.

Update Period: The endpoint is updated after every finished match.
Recommended Calls: Limit calls to 1 per finished match.

Use Cases

Get standings
https://hockey.sportdevs.com/standings

Get standing based on the id
https://hockey.sportdevs.com/standings?id=eq.{id}

Get standing from a specific league_id
https://hockey.sportdevs.com/standings?league_id=eq.{league_id}

Get standing from a specific league_id and season_id
https://hockey.sportdevs.com/standings?league_id=eq.{league_id}&season_id=eq.{season_id}

Get standing from a specific league_id, season_id and type
https://hockey.sportdevs.com/standings?league_id=eq.{league_id}&season_id=eq.{season_id}&type=eq.{type}

Query Parameters

• id integer

  Default value: eq.53283

  The id of the standing

• type text

  Default value: eq.total

  The type of the standing

• season_id integer

  Default value: eq.13037

  The id of the season

• league_id integer

  Default value: eq.2221

  The id of the league

• offset string

  Default value: 0

  Limiting and Pagination

• limit string

  Default value: 50

  Limiting and Pagination

• lang string

  Default value: en

  Multi-language

Responses

• 200

---

OK

application/json

• Schema
• Example (from schema)

---

Schema array

• id integer

  The id of the standing

  Note: This is a Primary Key.

• tournament_id integer

  The id of the tournament

  Note: This is a Foreign Key to seasons-by-tournament.tournament_id.

• tournament_name text

  The name of the tournament

• type text

  The type of the standing

• name text

  The name of the standing

• season_id integer

  The id of the season

  Note: This is a Foreign Key to seasons.id.

• season_name text

  The name of the season

• league_id integer

  The id of the league

  Note: This is a Foreign Key to leagues.id.

• league_name text

  The name of the league

• league_hash_image text

  The name image of the league

• competitors jsonb

  The competitors of the standing

[
  {
    "id": 53283,
    "tournament_id": 7508,
    "type": "total",
    "name": "SDHL, Women 22/23, Relegation/Promotion Round",
    "season_id": 13037,
    "season_name": "SDHL, Women 22/23",
    "league_id": 2221,
    "league_name": "SDHL",
    "league_hash_image": "126bc9e7c8909ee3a024ee7562e4abef9dc6e353222809b23967bd49d77e30d5",
    "competitors": [
      {
        "wins": 0,
        "draws": 0,
        "losses": 4,
        "points": 0,
        "matches": 4,
        "team_id": 35542,
        "position": 3,
        "team_name": "Skellefteå AIK",
        "scores_for": 6,
        "penalty_wins": 0,
        "penalty_losses": 0,
        "scores_against": 19,
        "team_hash_image": "c35b539cbedf9694fe436891e83b33e8e43c862eefe35f9dca6bd6101008054d",
        "overtime_and_penalty_losses": 0
      },
      {
        "wins": 2,
        "draws": 0,
        "losses": 2,
        "points": 7,
        "matches": 4,
        "team_id": 35368,
        "position": 2,
        "team_name": "AIK IF",
        "scores_for": 14,
        "penalty_wins": 0,
        "penalty_losses": 0,
        "scores_against": 14,
        "team_hash_image": "c7e3cc057cf519eb9b5823ee068ab415bfaa07f3a9405827e9238d796cbdcf80",
        "overtime_and_penalty_losses": 1
      },
      {
        "wins": 4,
        "draws": 0,
        "losses": 0,
        "points": 11,
        "matches": 4,
        "team_id": 35306,
        "position": 1,
        "team_name": "Frolunda HC",
        "scores_for": 19,
        "penalty_wins": 0,
        "penalty_losses": 0,
        "scores_against": 6,
        "team_hash_image": "e392f4d84555d7f776c9518331bbfbbb8e68b7304461470891fce7a17b848620",
        "overtime_and_penalty_losses": 0
      }
    ]
  }
]

Loading...