GET Standings by Season ID

GET Standings by Season ID

https://soccer.sportmonks.com/api/v2.0/standings/season/{season_ID}

Endpoint details
Authorization	API Key
Pagination	NO
Allowed nested includes	2

Parameters

Available parameters
include	Enrich the API with more data and/or nested includes. Can be used by adding &include= etc. to your request url.
stage_ids	A Comma separated list of stage ids. Can be used by adding &stage_ids= etc. to your request url.
group_ids	A Comma separated list of group ids. Can be used by adding &group_ids= etc. to your request url.

Include options

Note that includes on this endpoint must be prefixed by "standings."

team league season round stages

Includes are the cornerstone of our API and allow you to enrich and customize your requests. This flexibility is what distinguishes us from our competitors.

You can learn more about what includes are and how they work here:

pageIncludes

Example response

Request

https://soccer.sportmonks.com/api/v2.0/standings/season/17420?api_token={API_TOKEN}

Response

"data": [
        {
            "id": 77448322,
            "name": "Regular Season",
            "league_id": 8,
            "season_id": 17420,
            "round_id": 202038,
            "round_name": 38,
            "type": "Group Stage",
            "stage_id": 77448322,
            "stage_name": "Regular Season",
            "resource": "stage",
            "standings": {
                "data": [
                    {
                        "position": 1,
                        "team_id": 9,
                        "team_name": "Manchester City",
                        "round_id": 202038,
                        "round_name": 38,
                        "group_id": null,
                        "group_name": null,
                        "overall": {
                            "games_played": 38,
                            "won": 27,
                            "draw": 5,
                            "lost": 6,
                            "goals_scored": 83,
                            "goals_against": 32,
                            "points": 86
                        },
                        "home": {
                            "games_played": 19,
                            "won": 13,
                            "draw": 2,
                            "lost": 4,
                            "goals_scored": 43,
                            "goals_against": 17,
                            "points": 41
                        },
                        "away": {
                            "games_played": 19,
                            "won": 14,
                            "draw": 3,
                            "lost": 2,
                            "goals_scored": 40,
                            "goals_against": 15,
                            "points": 45
                        },
                        "total": {
                            "goal_difference": "51",
                            "points": 86
                        },
                        "result": "UEFA Champions League",
                        "points": 86,
                        "recent_form": "WLWLW",
                        "status": null
                    },
                    {
                        "position": 2,
                        "team_id": 14,
                        "team_name": "Manchester United",
                        "round_id": 202038,
                        "round_name": 38,
                        "group_id": null,
                        "group_name": null,
                        "overall": {
                            "games_played": 38,
                            "won": 21,
                            "draw": 11,
                            "lost": 6,
                            "goals_scored": 73,
                            "goals_against": 44,
                            "points": 74
                        },
                        "home": {
                            "games_played": 19,
                            "won": 9,
                            "draw": 4,
                            "lost": 6,
                            "goals_scored": 38,
                            "goals_against": 28,
                            "points": 31
                        },
                        "away": {
                            "games_played": 19,
                            "won": 12,
                            "draw": 7,
                            "lost": 0,
                            "goals_scored": 35,
                            "goals_against": 16,
                            "points": 43
                        },
                        "total": {
                            "goal_difference": "29",
                            "points": 74
                        },
                        "result": "UEFA Champions League",
                        "points": 74,
                        "recent_form": "WLLDW",
                        "status": null
                    },

Field Description

Season Field Description

Field	Description
id	The unique id of the current stage
name	The name of the stage
league_id	The unique league id the stage belongs to
season_id	The unique id of the current season
round_id	The unique id of the current round
round_name	The name of the round
type	Indicates what kind of type this stage is
stage_id	The unique id of the current stage
stage_name	The name of the stage

Standings Field Description

Field	Description
position	The actual position in the rankings in the stage
team_id	The unique team id of the team in that position in the stage
team_name	The team name in that position in the stage
round_id	The unique id of the current round
round_name	The name of the round
group_id	The unique id of the group, in which the team participates in
group_name	The name of the group, in which the team participates in
overall	The overall results of the team, i.e., the number of games, points and goals
home	The home results of the team, i.e., the number of games, points and goals
away	The away results of the team, i.e., the number of games, points and goals
total	The total points of the team and their goal difference
results	The standing rules of the place the team is in
points	The accumulated number of points the team has
recent_form	The recent form of the team
status	Will be available in API 3.0: Indicates if the team moves up on down based on the last standings.

Check this endpoint in Postman.