FOOTBALL API
Sign inRequest a key
The collectionDocumentationMembershipStatusSupport
Sign inRequest a key
Documentation / Seasons

FOOTBALL LEAGUE TABLE API

Table
Complimentary keyMCP tool league_table

A league table as it stands this morning, or as it stood on any date you pass, for home matches, away matches or both. Competitions played in groups return each group. On the complimentary key it reads this season's Premier League.

GET/v1/competitions/{competition}/seasons/{season}/table
TRY ITComplimentary
Kept in this browser for every docs page. No key yet? Get a free key
GET https://api.footballapi.org/v1/competitions/premier-league/seasons/2026/table
The answer appears below, with its status and time.
curl "https://api.footballapi.org/v1/competitions/premier-league/seasons/2026/table" \
  -H "X-API-Key: your key"

PARAMETERS

competitionrequiredstringA competition from /v1/competitions, such as premier-league. In the path.
seasonrequiredintegerThe first year of the season: 2026 for 2026/27. In the path.From 2015, or the competition's first season
datedateThe table on the morning of this day, YYYY-MM-DD.
venuestringA table of home matches only, or away matches only.home or away

RETURNS

competitionstringThe competition's name in the collection, such as premier-league
country_namestringThe country, or World or Europe for a tournament
competition_namestringThe competition as people write it
season_start_yearintegerThe first year of the season: 2026 for 2026/27
as_ofnull or moreThe day the table stands on; null for this morning
venuenull or morehome or away when the table counts only those; null for both
tablelistEach club in the table, top first
table[].positionintegerPlace in the table
table[].club_idstringOur id for the club, cl_ and 9 characters, the same in every answer and for good
table[].club_namestringThe club
table[].playedintegerMatches counted
table[].wonintegerMatches won
table[].drawnintegerMatches drawn
table[].lostintegerMatches lost
table[].goals_forintegerGoals scored
table[].goals_againstintegerGoals let in
table[].goal_differenceintegerGoals scored less goals let in
table[].pointsintegerThree for a win, one for a draw

EXAMPLE ANSWER

200GET /v1/competitions/premier-league/seasons/2026/table, taken 21 Oct 2026, first rows shown
{
  "data": {
    "competition": "premier-league",
    "country_name": "England",
    "competition_name": "Premier League",
    "season_start_year": 2026,
    "as_of": null,
    "venue": null,
    "table": [
      {
        "position": 1,
        "club_id": "cl_a7vhnxhhh",
        "club_name": "Manchester City",
        "played": 7,
        "won": 7,
        "drawn": 0,
        "lost": 0,
        "goals_for": 19,
        "goals_against": 7,
        "goal_difference": 12,
        "points": 21
      },
      {
        "position": 2,
        "club_id": "cl_9cbmhewrg",
        "club_name": "Arsenal",
        "played": 7,
        "won": 6,
        "drawn": 0,
        "lost": 1,
        "goals_for": 11,
        "goals_against": 5,
        "goal_difference": 6,
        "points": 18
      },
      {
        "position": 3,
        "club_id": "cl_4tesczsmh",
        "club_name": "Brighton",
        "played": 7,
        "won": 5,
        "drawn": 1,
        "lost": 1,
        "goals_for": 23,
        "goals_against": 5,
        "goal_difference": 18,
        "points": 16
      }
    ]
  },
  "meta": {
    "competition": "premier-league",
    "season": "2026/27",
    "as_of": "2026-10-21",
    "request_id": "req_bb2de28f6a88eedb"
  }
}

ERRORS

401unauthorizedNo key, or a key we do not know.
400bad_requestA parameter is missing or not in the right form; the message names it.
403upgrade_requiredAnything outside this season's Premier League, on the complimentary key.
404not_foundAn id or competition we do not have.
422unknown_parameterA parameter this endpoint does not take.
429quota_exceededThe day's 50 calls are used, on the complimentary key; they reset at 00:00 UTC.
PREVIOUSSeasonNEXTPositions