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, points, and recent form for every team.

GET /football/standings?competition_id=1&season=2025

Example request

const res = await fetch(
  "https://api.thestatsapi.com/api/football/standings?competition_id=1&season=2025",
  { headers: { Authorization: "Bearer YOUR_API_KEY" } }
);
const data = await res.json();
console.log(data);
JSON response
{
  "data": {
    "competition": "Premier League",
    "season": "2025/26",
    "table": [
      {
        "rank": 1, "team": "Manchester City", "played": 20,
        "won": 15, "drawn": 3, "lost": 2,
        "gf": 48, "ga": 18, "gd": 30, "points": 48,
        "form": ["W", "W", "D", "W", "L"]
      }
    ]
  }
}

Key response fields

rank

Current league position.

points / gd

Points and goal difference for sorting.

form

Most recent results, newest first.

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.

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. Pass any supported season parameter to retrieve historical standings.

Do you support group-stage tables?

Yes. Competitions with groups (e.g. Champions League, World Cup) return per-group standings.

Pricing_Plans

Simple, Transparent Pricing

Every plan includes stats, odds, xG, history, and every documented endpoint.

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, Betfair Exchange & 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
  • 80 competitions by default, up to 1,196 on request
  • 100,000 requests/month
  • 120 requests/min
  • Email & chat support
Most Popular

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