FIXTURES_API

2026 FIFA World Cup Fixtures API

Every fixture in the 2026 FIFA World Cup - all 104 matches across 12 groups and 7 knockout stages - delivered as clean JSON via REST. Includes kickoff times in UTC, venues, host cities, and the team ID and name for each side.

104 matches: 72 group stage + 32 knockout
Kickoff times in UTC + venue + stadium
12 groups A-L with home/away ordering
Round of 32 → Final knockout bracket
Filter by team_id, group, stage, or date range
Updates as fixtures shift or are postponed

Complete schedule from day one

The fixtures endpoint returns the full schedule the moment the draw is announced. Use it to populate calendars, build match-day reminders, or seed your prediction game with the full bracket from kickoff to the final.

Knockout rounds

Knockout fixtures carry a stage_name (round_of_32, round_of_16, quarter_final, semi_final, final) so you can place each match in the bracket. Refetch them with stage=playoff once the group stage resolves to pick up the qualified teams.

Filter by group, stage, team, or date

Query parameters cover every realistic use case: group=A through L, stage=regular (group stage) or stage=playoff (knockouts), team_id=<id>, status, matchday, and date_from/date_to (YYYY-MM-DD; set both to the same day for a single date, with utc_offset for local days). Combine filters server-side instead of pulling the whole schedule and filtering client-side.

Built for bracket apps and prediction games

Every fixture exposes stage_name, group_label, status, and home_team / away_team IDs so you can render a complete 48-team bracket from one paginated call. Update fixture statuses live as the group stage resolves and knockout slots are filled.

ENDPOINT

/football/matches

Use competition_id=comp_6107 to scope this endpoint to the 2026 FIFA World Cup. The same endpoint works for 1,195 other competitions.

World Cup API IDs
Competition ID
comp_6107

FIFA World Cup (all editions)

Season ID (2026)
sn_118868

World Cup 2026

JavaScript
// Fetch all 104 World Cup 2026 fixtures
const response = await fetch(
  'https://api.thestatsapi.com/api/football/matches?competition_id=comp_6107&season_id=sn_118868&per_page=100',
  { headers: { 'Authorization': 'Bearer YOUR_API_KEY' } }
);
const { data } = await response.json();
// data holds the first 100 of 104 fixtures (newest kickoff first); request page=2 for the rest

What the World Cup 2026 fixtures API returns

Selected fields from the JSON response. Full schema and example payloads are in the developer docs.

FieldTypeDescription
idstringMatch ID used by the lineups, timeline, stats, and odds endpoints.
utc_dateISO 8601UTC kickoff time. Convert client-side as needed.
stage_namestring?round_of_32 | round_of_16 | quarter_final | semi_final | final for knockouts; null for group-stage fixtures and the third-place playoff.
group_labelstring?A-L for group-stage fixtures; null for knockouts.
home_team / away_teamobject{ id, name } for each side.
matchdayinteger?Group-stage round number.
venueobject{ name, city } on the single-match endpoint /football/matches/{match_id}.
statusstringscheduled | live | finished | postponed | cancelled.

What developers build with the World Cup 2026 fixtures API

Bracket challenge apps

Render the full 48-team bracket and accept predictions for every match.

Calendar & reminder bots

Subscribe users to UTC kickoff reminders in Telegram, Slack, or Discord.

Match-day landing pages

Build SEO-friendly fixture detail pages from the matches endpoint alone.

Live tickers & widgets

Combine fixtures + lineups + events to power broadcaster-grade match centre experiences.

Fantasy game seeding

Seed your fantasy gameweeks with the full World Cup schedule before kickoff.

Travel & ticket sites

Cross-reference fixtures with host city pages to surface match-day travel packages.

Implementation notes

  • Cache the full fixture list and refresh once per hour during the tournament — kickoff times rarely change after the draw.
  • Treat home / away as ordered slots, not always literal home advantage; in knockouts these are positional only.
  • Render UTC client-side using the user's browser timezone for a localised experience without a server round-trip.
  • When the group stage finishes, refetch knockout fixtures to pick up the resolved teams.
  • For push-style notifications, poll status=live on a short interval and diff the results on your side.

Frequently Asked Questions

How many matches are in the 2026 World Cup?

104 matches total: 72 group-stage matches across 12 groups, plus 32 knockout matches (16 Round of 32, 8 Round of 16, 4 quarter-finals, 2 semi-finals, 1 third-place playoff, and the Final).

When do World Cup 2026 fixtures start and end?

The tournament kicks off on June 11, 2026 at the Estadio Azteca in Mexico City. The Final is on July 19, 2026 at MetLife Stadium in New York/New Jersey. The tournament window spans 39 days.

How do I get only group stage fixtures?

Filter the matches endpoint by stage=regular or by date_from=2026-06-11&date_to=2026-06-27&utc_offset=-04:00 (so late kickoffs stay on their local day). You can also iterate per-group by filtering by group=A through L.

How fresh is fixture data when kickoff times change?

Schedule changes (postponements, kickoff-time shifts, venue swaps) propagate to the API within minutes of the official FIFA announcement.

What timezone are kickoff times in?

All kickoff timestamps are returned in UTC (ISO 8601). Convert to any local timezone client-side, or use our free /tools/match-kickoff-time-converter to compare across cities.

Can I get fixtures as iCalendar (.ics) for a personal calendar?

The API returns JSON only. To build a calendar feed, map each fixture's utc_date, home_team and away_team into .ics events on your side.

Start building with the World Cup 2026 API

7-day free trial. All endpoints included on every plan.