Football standings API

League tables for 14 competitions in one consistent JSON format — position, points, goal difference and last-five form for every team, updated after each round.

A league table looks simple until you need it for many leagues at once: different tie-breakers, renamed clubs, postponed matches and seasons that start in different months.

Our standings are calculated from match results with the same rules for every league and returned in one format. Need it on a website without code? Use the free league table widget instead.

Request parameters

ParameterDescription
seasonSeason, e.g. 2026/27 (default — current)
viewtotal, home or away table
includeform — add last-five form for every team
GET/v1/leagues/premier-league/table200 OK
{
  "league": "Premier League", "season": "2026/27",
  "updated_at": "2026-10-20T06:00:00Z",
  "standings": [
    { "pos": 1, "team": "Manchester City", "played": 7, "won": 7, "drawn": 0, "lost": 0,
      "gd": 12, "points": 21, "form": "WWWWW" },
    { "pos": 2, "team": "Arsenal", "played": 7, "points": 18, "gd": 6, "form": "WWLWW" },
    { "pos": 3, "team": "Brighton and Hove Albion", "played": 7, "points": 16, "gd": 18, "form": "WWWWD" }
    // … all 20 teams
  ],
  "source": "football-data.co.uk"
}
Response fields

What you get back

FieldTypeDescription
standings[]arrayOne row per team, ordered by position
pos / pointsintLeague position and points
won / drawn / lostintResults breakdown
gf / ga / gdintGoals for, against and goal difference
formstringLast five results, oldest to newest
updated_atdatetimeWhen the table was last recalculated (UTC)
Use cases

Built for people who publish football data

League pages

Publish always-current tables for every league you cover with a single cron job.

Match context

Show where both teams stand next to each fixture or prediction.

Bots and apps

Answer “/table epl” in a Telegram bot with one request.

FAQ

Standings API: questions

Which leagues have standings?

Premier League, Championship, LaLiga, Serie A, Bundesliga, Ligue 1, Eredivisie, Liga Portugal, Belgian Pro League, Scottish Premiership, Süper Lig, Brasileirão, Argentina Primera and MLS.

Are home and away tables available?

Yes — request view=home or view=away to get separate tables.

Is there a free option?

Yes. The free plan includes 100 requests a day, and the league table widget is free for any website.

Related

More from the API

Early access

Get your API key first

Free plan for small projects. Early-access users get 50% off for the first year.

Request early access