Standings endpoint

Football Standings API

Get live and historical league tables — points, goal difference, form, and rank — for any competition and season.

Quick answer

The football standings API returns the full league table for a competition and season, including played, won, drawn, lost, goals for/against, goal difference, and points for every team.

GET /football/competitions/comp_3039/seasons/sn_8406098/standings

Example request

const res = await fetch(
  "https://api.thestatsapi.com/api/football/competitions/comp_3039/seasons/sn_8406098/standings",
  { headers: { Authorization: "Bearer YOUR_API_KEY" } }
);
const data = await res.json();
console.log(data);

JSON response

{
  "data": [
    {
      "team": { "id": "tm_3039", "name": "Manchester City" },
      "position": 1,
      "matches_played": 5,
      "wins": 5, "draws": 0, "losses": 0,
      "goals_for": 13, "goals_against": 5, "goal_difference": 8,
      "points": 15,
      "group_label": null
    }
  ]
}

Key response fields

position

Current league (or group) position.

points / goal_difference

Points and goal difference for sorting.

group_label

Group letter (A-L) for group-stage tournaments; null for leagues.

matches_played

Matches played so far this season.

What you can build with the Football Standings API

Live league table widgets

Promotion/relegation trackers

Standings history snapshots

Model features (table position, form)

The Football Standings API is part of TheStatsAPI, a single REST API covering 1,000+ football competitions with fixtures, results, standings, player and match stats, odds, and xG. Plans start at $50/month with a 7-day free trial and every endpoint included.

Related endpoints

Frequently Asked Questions

Are standings live?

Yes. Tables recompute as results settle, so standings reflect the latest finished matches.

Can I get past-season tables?

Yes. Use any season_id from /football/competitions/{competition_id}/seasons in the path to retrieve historical standings.

Do you support group-stage tables?

Yes. Competitions with groups (e.g. Champions League, World Cup) return per-group standings rows with group_label set; add ?group=A to fetch one group.

Pricing_Plans

Simple, Transparent Pricing

All stats data — fixtures, results, match & player stats, xG, and history.

Starter

$50/month

For prototypes, side projects, and early products

Included in every plan:

All football data endpoints included
Pre-match & live odds endpoints
Bet365, Pinnacle, Paddy Power, Betfair Sportsbook & Kambi odds
1X2, Asian handicap, totals, BTTS, DNB & corners
Fixtures, results, match stats, teams & players
xG, player season stats & team stats
10 years of historical match data
Build with AI
150 competitions by default, up to 1,196 on request
100,000 requests/month
120 requests/min
Email & chat support

Growth

$129/month

For production apps with steady traffic

Everything in Starter, plus:

500,000 requests/month
300 requests/min
Priority support for production teams

Scale

$379/month

For high-volume, production-grade usage

Everything in Growth, upgraded to:

5,000,000 requests/month
1,000 requests/min
Dedicated support & SLA

Cancel anytime

7-day free trial on all plans

Build with the Football Standings API today

Start a 7-day free trial. Every endpoint and competition is included on every plan.

Get your API key