Live scores endpoint

Football Live Scores API

Stream real-time football scores, the current match minute, and goal events for live matches across more than 1,000 competitions.

Start free trial Browse leagues

Quick answer

The football live scores API returns in-play matches with live score, current minute, and recent events, so you can power live score widgets, push notifications, and in-play products.

GET /football/matches?status=live

Example request

const res = await fetch(
  "https://api.thestatsapi.com/api/football/matches?status=live",
  { headers: { Authorization: "Bearer YOUR_API_KEY" } }
);
const data = await res.json();
console.log(data);

JSON response

{
  "data": [
    {
      "match_id": "mt_25262",
      "competition": "Premier League",
      "status": "live",
      "minute": 67,
      "home": { "name": "Chelsea", "score": 2 },
      "away": { "name": "Tottenham", "score": 2 },
      "last_event": { "minute": 64, "type": "goal", "team": "Tottenham" }
    }
  ]
}

Key response fields

minute

Current match minute for live games.

status

live for in-play matches.

score

Live running score per team.

last_event

Most recent goal, card, or substitution.

What you can build with the Football Live Scores API

Live score widgets and tickers

Push notification services

In-play betting products

Second-screen match experiences

The Football Live Scores 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.