Getting Started
Endpoint overview
Tutorials
Tools
How-to Guides
API References
General
League standings
Step 1: Gather the tools
You are going to need the following tools:
- Sportmonks API token
- Code editor (Visual studio used in examples)
- Postman (optional)
You can find a link to another article where we discuss the tools in-depth on our Developer Tools Guide.​
Step 2: Determine the league and season
What league and specifically what season interests you? For this guide, we’ll go with the 20/21 season of the Scottish Premiership (league id: 501, season id: 17141).
Step 3: Choose the correct endpoint
1
https://soccer.sportmonks.com/api/v2.0/standings/season/17141?api_token={API_TOKEN}
Copied!
You only need to parse a season id. Simple and straightforward, just the way we like it.
Step 4: Analyze the response
1
"data": [
2
{
3
"id": 77447501,
4
"name": "1st Phase",
5
"league_id": 501,
6
"season_id": 17141,
7
"round_id": 194976,
8
"round_name": 9,
9
"type": "Group Stage",
10
"stage_id": 77447501,
11
"stage_name": "1st Phase",
12
"resource": "stage",
13
"standings": {
14
"data": [
15
{
16
"position": 1,
17
"team_id": 62,
18
"team_name": "Rangers",
19
"round_id": 194976,
20
"round_name": 9,
21
"group_id": null,
22
"group_name": null,
23
"overall": {
24
"games_played": 11,
25
"won": 9,
26
"draw": 2,
27
"lost": 0,
28
"goals_scored": 26,
29
"goals_against": 3
30
},
31
"home": {
32
"games_played": 5,
33
"won": 5,
34
"draw": 0,
35
"lost": 0,
36
"goals_scored": 14,
37
"goals_against": 0
38
},
39
"away": {
40
"games_played": 6,
41
"won": 4,
42
"draw": 2,
43
"lost": 0,
44
"goals_scored": 12,
45
"goals_against": 3
46
},
47
"total": {
48
"goal_difference": "23",
49
"points": 29
50
},
51
"result": "Championship Round",
52
"points": 29,
53
"recent_form": "WDWWW",
54
"status": null
55
},
56
{
57
"position": 2,
58
"team_id": 53,
59
"team_name": "Celtic",
60
"round_id": 194976,
61
"round_name": 9,
62
"group_id": null,
63
"group_name": null,
64
"overall": {
65
"games_played": 10,
66
"won": 8,
67
"draw": 1,
68
"lost": 1,
69
"goals_scored": 25,
70
"goals_against": 7
71
},
72
"home": {
73
"games_played": 5,
74
"won": 4,
75
"draw": 0,
76
"lost": 1,
77
"goals_scored": 14,
78
"goals_against": 5
79
},
80
"away": {
81
"games_played": 5,
82
"won": 4,
83
"draw": 1,
84
"lost": 0,
85
"goals_scored": 11,
86
"goals_against": 2
87
},
88
"total": {
89
"goal_difference": "18",
90
"points": 25
91
},
92
"result": "Championship Round",
93
"points": 25,
94
"recent_form": "WWWWL",
95
"status": null
96
},
Copied!
We can see that the Rangers are in first place with 11 games played, nine won and two draws, and their number of accumulated points is 29.
They are followed by 2nd place Celtic, with ten games played, 8 won, one draw and one loss, and 25 points.
There is a lot more information regarding their standings that you can opt to use for your application.
Need standings based on a group? In our leagues & topscorers standings tutorial, we discuss all the possibilities.
Export as PDF
Copy link