Results endpoint

Football Results API

Fetch final scores, goal events, and outcomes for completed matches across more than 1,000 competitions and decades of history.

Start free trial Browse leagues

Quick answer

The football results API returns completed matches with final scores, half-time scores, and goal events. Filter by competition, team, or season to build results archives and compute team form.

GET /football/matches?competition_id=1&status=finished

Example request

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

JSON response

{
  "data": [
    {
      "match_id": "mt_10477",
      "competition": "Premier League",
      "status": "finished",
      "kickoff_utc": "2025-12-26T15:00:00Z",
      "home": { "name": "Liverpool", "score": 3, "ht_score": 1 },
      "away": { "name": "Leicester City", "score": 1, "ht_score": 0 }
    }
  ],
  "meta": { "page": 1, "per_page": 25, "total": 380 }
}

Key response fields

score

Full-time goals for home and away.

ht_score

Half-time goals for each side.

status

finished for completed matches.

match_id

Join to events, stats, and odds endpoints.

What you can build with the Football Results API

Results archives and history pages

Team form and streak calculators

Backtesting prediction models

Settlement and grading engines

The Football Results 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.