Group Standings

Endpoint
Response
Examples

On this football API documentation page, we show how you can get the standings for a single group.

The group standings football API endpoint supports teams names in various languages to find out more about this, read through our documentation on language support.

The performance and form of the teams in a competition are clearly seen in the group standings. That is why group classification is an integral part of any football data and people are interested in it. We provide our subscribers with the possibility to get the current standings of any group using this dedicated football API endpoint. This API endpoint provides the standings for a single groups. If you want to get the standings for all the groups of a competition you should use the competition standings API endpoint.

Endpoint

In order, to benefit from using this football API endpoint you need only to know the id of the group which standings you would like to get and alternately the code of the language that you want the data to be translated in. To find the id of the group that you need you can either use the competition standings and extract the group id from there or you can use the competition groups API endpoint and extract the group id from its response. In the example URL we are showing how you can get the group standings using the regular season group of the English Premier League for season 2023/2024.

GET:

The group standings football API endpoint supports a couple of parameters that you can use. The parameters are listed in the table below. You can use the parameters together as with the group_id to modify the response data.

Name	Type	Required	Example	Description
group_id	Number	1	2684	The `ID` of the group which standings you need
include_form	integer		1	Adds the teams last 6 matches form to the response data
lang	String		ar	The ISO alpha2 code of the language in which you want the team names.

Response

All the teams participating in the group with their relevant standings data will be present in the response. In the JSON example below, we have included a small set of the teams participating in the English Premier League. The actual response from this football API endpoint will contain all 20 teams. Also, in the example request that formed the response in the highlighted rectangle, we have set the include_form parameter value to be equal to 1 and that is why you can also see the teams' form in the response.

{
    "success": true,
    "data": {
        "competition": {
            "id": 362,
            "name": "FIFA World Cup",
            "is_league": false,
            "is_cup": true,
            "tier": 0,
            "has_groups": true,
            "active": true,
            "national_teams_only": true
        },
        "season": {
            "id": 11,
            "name": "2022",
            "start": "2022-01-01",
            "end": "2022-12-31"
        },
        "stage": {
            "id": 1231,
            "name": "Group Stage"
        },
        "group": {
            "id": 1913,
            "name": "A",
            "standings": [
                {
                    "rank": 1,
                    "points": 7,
                    "matches": 3,
                    "goal_diff": 4,
                    "goals_scored": 5,
                    "goals_conceded": 1,
                    "lost": 0,
                    "drawn": 1,
                    "won": 2,
                    "form": [
                        "D",
                        "W",
                        "W",
                        "D",
                        "W",
                        "W"
                    ],
                    "team": {
                        "id": 1649,
                        "name": "Netherlands",
                        "stadium": "Johan Cruijff Arena",
                        "country_id": 115,
                        "logo": "https:\/\/cdn.live-score-api.com\/teams\/e7b73bb0ba5e8f87600ddb792055fef1.png"
                    }
                },
                {
                    "rank": 2,
                    "points": 6,
                    "matches": 3,
                    "goal_diff": 1,
                    "goals_scored": 5,
                    "goals_conceded": 4,
                    "lost": 1,
                    "drawn": 0,
                    "won": 2,
                    "form": [
                        "L",
                        "W",
                        "W",
                        "L",
                        "L",
                        "D"
                    ],
                    "team": {
                        "id": 1460,
                        "name": "Senegal",
                        "stadium": "Stade L\u00e9opold S\u00e9dar Senghor",
                        "country_id": 118,
                        "logo": "https:\/\/cdn.live-score-api.com\/teams\/5a59119619a8e1b32c7970ffa572e1b0.png"
                    }
                },
                {
                    "rank": 3,
                    "points": 4,
                    "matches": 3,
                    "goal_diff": 1,
                    "goals_scored": 4,
                    "goals_conceded": 3,
                    "lost": 1,
                    "drawn": 1,
                    "won": 1,
                    "form": [
                        "L",
                        "D",
                        "W",
                        "D",
                        "W",
                        "L"
                    ],
                    "team": {
                        "id": 1847,
                        "name": "Ecuador",
                        "stadium": "Estadio Ol\u00edmpico Atahualpa",
                        "country_id": 117,
                        "logo": "https:\/\/cdn.live-score-api.com\/teams\/a8a7fab18209c5f3e6682f91cfa7d074.png"
                    }
                }
            ]
        }
    }
}

Name	Type	Example	Description
competition	object	{}	An object holding the information about the competition for which you are getting the standings. It has the structure of our standard competition object.
drawn	Number	7	the number of drawn matches
goal_diff	Number	52	the goal difference of the team, if it is negative, it will be a negative number e.g. -6
goals_conceded	Number	18	the number of goals the team conceded in their own goal
goals_scored	Number	70	the number of goals the team scored in their opponents goals
group	object	{}	An array holding the information about the group `id` and `name` together with the standings
group.standings	Array	[]	An array holding all teams in the group table together with their standings related data
group.standings.form	Array	W, L, D	The for of the team in the last 6 matches from the competition
group.standings.team	object	{}	An object holding the information about the team in the standings. It has the structure of our standard team object.
lost	Number	1	the number of games the team lost
matches	Number	31	the number of matches that the team has played
points	Number	76	number of points accumulated
rank	Number	1	the rank in the standings table that the team occupies
season	object	{}	An object holding the information about the season for which you are getting the standings of the competition. It has the structure of our standard season object.
stage	object	{}	An object holding information about the stage: `id` and `name`
won	Number	23	the number of matches the team won

Examples

cUrl:

curl -XGET "https://livescore-api.com/api-client/groups/table.json?group_id=2684&key=demo_key&secret=demo_secret"

PHP:

file_get_contents('https://livescore-api.com/api-client/groups/table.json?group_id=2684\&key=demo_key\&secret=demo_secret');

Python:

import urllib2
req = urllib2.Request('https://livescore-api.com/api-client/groups/table.json?group_id=2684\&key=demo_key\&secret=demo_secret')
response = urllib2.urlopen(req)
print response.read()

To modify the response so that the team form is included, you need to add the following query parameter to your football API request URL &include_form=1. Here are some examples: