Fixtures endpoint

Football Fixtures API

Pull upcoming and historical football fixtures — kickoff times, venues, and team IDs — across more than 1,000 competitions from one endpoint.

Start free trial Browse leagues

Quick answer

The football fixtures API returns scheduled and completed matches for any competition or team, including kickoff time (UTC), venue, status, and the IDs you need to fetch odds, stats, and lineups for each match.

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

Example request

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

JSON response

{
  "data": [
    {
      "match_id": "mt_10481",
      "competition": "Premier League",
      "status": "scheduled",
      "kickoff_utc": "2026-01-18T15:00:00Z",
      "venue": "Etihad Stadium",
      "home": { "team_id": 50, "name": "Manchester City" },
      "away": { "team_id": 42, "name": "Arsenal" }
    }
  ],
  "meta": { "page": 1, "per_page": 25, "total": 380 }
}

Key response fields

match_id

Unique match identifier used by every other endpoint.

kickoff_utc

Scheduled kickoff time in UTC (ISO 8601).

status

scheduled, live, finished, postponed or cancelled.

venue

Stadium name where the match is played.

What you can build with the Football Fixtures API

Fixture lists and calendars

Match reminder and notification apps

Pre-match model pipelines

Editorial preview generation

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