Football Fixtures API
Pull upcoming and historical football fixtures — kickoff times, venues, and team IDs — across more than 1,000 competitions from one endpoint.
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=comp_3039&season_id=sn_8406098&status=scheduledExample request
const res = await fetch(
"https://api.thestatsapi.com/api/football/matches?competition_id=comp_3039&season_id=sn_8406098&status=scheduled",
{ headers: { Authorization: "Bearer YOUR_API_KEY" } }
);
const data = await res.json();
console.log(data);{
"data": [
{
"id": "mt_899744264",
"competition_id": "comp_3039",
"season_id": "sn_8406098",
"matchday": 10,
"stage_name": null,
"status": "scheduled",
"utc_date": "2026-11-08T16:30:00.000Z",
"home_team": { "id": "tm_4643", "name": "Manchester United" },
"away_team": { "id": "tm_1002", "name": "Aston Villa" },
"score": { "home": null, "away": null },
"odds_available": false
}
],
"meta": { "page": 1, "per_page": 20, "total": 50, "total_pages": 3 }
}Key response fields
idUnique match identifier used by every other endpoint.
utc_dateScheduled kickoff time in UTC (ISO 8601).
statusscheduled, live, finished, postponed or cancelled.
home_team / away_teamTeam id and name for each side. Venue is on the single-match endpoint.
What you can build with the Football Fixtures API
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.
Frequently Asked Questions
Can I filter fixtures by date or team?
Yes. Filter by competition_id, season_id, team_id, status, and a date_from/date_to range (YYYY-MM-DD). Combine filters to fetch exactly the fixtures you need.
How far in advance are fixtures available?
Fixtures appear as soon as competitions publish their schedules — typically the full season for league competitions and round-by-round for cups.
How do I get odds for a fixture?
Use the match id from the fixtures response with the odds endpoint to fetch Bet365, Pinnacle, Paddy Power, Betfair Sportsbook, and Kambi prices.
Simple, Transparent Pricing
All stats data — fixtures, results, match & player stats, xG, and history.
Starter
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
For production apps with steady traffic
Everything in Starter, plus:
- 500,000 requests/month
- 300 requests/min
- Priority support for production teams
Scale
For high-volume, production-grade usage
Everything in Growth, upgraded to:
- 5,000,000 requests/month
- 1,000 requests/min
- Dedicated support & SLA
Build with the Football Fixtures API today
Start a 7-day free trial. Every endpoint and competition is included on every plan.
Get your API key