FOOTBALL SEASONS AND TABLES DATA

Any league table as it stood on any morning since 2015/16, every club's place before every match, and each season's clubs, matches and figures.

A SEASON

Everything about a season hangs under /v1/competitions/{competition}/seasons/{season}. The season is its first year, so 2026 is 2026/27.

THE TABLE, NOW OR ON ANY DAY

…/table gives the league table. Add date for the table as it stood on that morning, and venue for home or away matches only.

curl "https://api.footballapi.org/v1/competitions/premier-league/seasons/2026/table" \
  -H "X-API-Key: your key"

import requests

r = requests.get(
    "https://api.footballapi.org/v1/competitions/premier-league/seasons/2026/table",
    headers={"X-API-Key": "your key"},
)
print(r.json()["data"])

const res = await fetch("https://api.footballapi.org/v1/competitions/premier-league/seasons/2026/table", {
  headers: { "X-API-Key": "your key" },
});
const { data } = await res.json();
console.log(data);

$ch = curl_init("https://api.footballapi.org/v1/competitions/premier-league/seasons/2026/table");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["X-API-Key: your key"],
]);
$data = json_decode(curl_exec($ch), true)["data"];
print_r($data);

POSITIONS BEFORE EVERY MATCH

…/positions gives where every club stood before each of its matches: the table at every kickoff, without rebuilding it yourself.

CLUBS, MATCHES AND FIGURES

…/clubs lists the season's clubs with their grounds; …/matches every match in kickoff order; …/stats the season in figures.

COMPETITIONS IN GROUPS

Where a competition is played in groups, the answer has one part for each group.

WHICH SEASONS

From 2015/16, or the league's first season in the collection; an earlier season answers 404 not_found naming the first one. On the complimentary key, seasons read this season's Premier League.