League Table

Get All Tables for a League Season

GEThttps://api.football-data-api.com/league-tables?key=YOURKEY&season_id=X

Sample Response (Access the URL below)
https://api.football-data-api.com/league-tables?key=example&season_id=2012

Returns the data of each team as a JSON array.
Add &include=stats to the request to get the stats of each team !

Query Parameters

Name

Type

Description

max_time

integer

UNIX Timestamp. Set this number if you would like the API to return the stats of the league and the teams up to a certain time. For example, if I enter &max_time=1537984169, then the API will respond with stats as of September 26th, 2019.

key*

string

Your API Key

season_id*

integer

ID of the league season that you would like to retrieve.

200 Successfully retrieved all leagues.

Hide ↑

Copy

Show↓

Queries and Parameters

You can test this API call by using the key "example" and loading the league tables from the English Premier League 2018/2019 season (ID: 1625).

Variable Name

Description

league_table

If the league only has a single round with no play-off matches (ie Premier League), the League Table is stored here.
Returns NULL if the league is a Cup format.

all_matches_table_overall

Full table across all matches played during the season. For example, if this is a cup competition, then we will generate a table with all teams across all the matches that they've played. This is not necessarily the league table.

all_matches_table_home / all_matches_table_away

Full table only taking into account either Home matches or Away matches.

specific_tables

Array. Contains tables for each round of a season. Many leagues in the world have multiple rounds with league tables during 1 season.

ie Uruguay Primera Division:
Apertura - Table.
Intermediate Round - Group Tables.
Clausura - Table.
Final Play-Offs - NULL (no table).

ie Championship :
Regular Season - Table.
Play-Offs - NULL (no table).
ie UEFA Champions League.
Qualification Matches - NULL (no table).
Group Round - Table for each group.
8th Finals - NULL (no table).
Quarter Finals - NULL (no table).

Previous Match Details (Stats, H2H, Odds Comparison) Next Player - individual