RESULTS_API

2026 FIFA World Cup Results API

Live scores, full-time results, and complete match event timelines for every 2026 FIFA World Cup fixture. Get goals, cards, substitutions, VAR decisions, and possession by half in one consistent JSON shape.

Live scores updated in real time
Full-time scores + half-time scores
Match events: goals, cards, subs, VAR
Possession, shots, corners by half
Filter by status: live, finished, scheduled
10-year historical archive for context

Live and final results in one endpoint

The matches endpoint returns scheduled, in-play, and finished matches. Use the status filter to fetch just live matches for ticker apps, or just finished matches for archives.

Match event timelines

The /football/matches/{match_id}/timeline endpoint returns an ordered event list for every finished match: goals, yellow and red cards, substitutions, penalties, and VAR decisions, each with team and player. Useful for building match-centre views and notification systems.

Half-time and possession breakdowns

Half-time scores are on the single-match endpoint, and /football/matches/{match_id}/stats returns shots on/off target, corners, possession %, and aerial duels split by first and second half.

Knockout-stage extras

Extra-time events are tagged with period extra_time_first_half / extra_time_second_half. Shoot-out kicks come through with period penalties, in order, with the shooter and outcome (penalty_scored / penalty_missed / penalty_saved), and score.penalty_shootout carries the total, so you can render a full shootout view.

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
// Live and finished World Cup 2026 results
const response = await fetch(
  'https://api.thestatsapi.com/api/football/matches?competition_id=comp_6107&season_id=sn_118868&status=finished&per_page=100',
  { headers: { 'Authorization': 'Bearer YOUR_API_KEY' } }
);
const { data } = await response.json();
// Each match includes the final score; fetch /football/matches/{id}/timeline
// for goals, cards, substitutions, and VAR events

What the World Cup 2026 results API returns

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

FieldTypeDescription
statusstringscheduled | live | finished | postponed | cancelled.
scoreobject{ home, away, regulation, after_extra_time, penalty_shootout, went_to_extra_time, went_to_penalties, winner }.
eventsarrayFrom /timeline: goal | yellow_card | red_card | substitution | penalty_* | var and more.
minuteintegerMatch minute of the event.
extra_timeintegerStoppage minutes on top of minute (45+2 = minute 45, extra_time 2).
playerobjectPlayer for the event (scorer, booked player, etc.).
periodstringfirst_half | second_half | extra_time_first_half | extra_time_second_half | penalties.

What developers build with the World Cup 2026 results API

Live tickers & notification bots

Push goals, cards, and full-time results to Slack, Discord, or mobile push channels.

Match-centre dashboards

Render a full match timeline, lineups, stats, and possession in one view.

News site auto-publishing

Trigger article-template auto-publish when a match ends, using events + xG.

Voice assistant skills

"Hey Siri, what was the World Cup score?" — back the skill with /matches?status=live.

Implementation notes

  • Poll status=live only while matches are in play to avoid burning your rate limit on hot paths.
  • Render injury-time minutes correctly: 45+2 means minute=45, extra_time=2.
  • Treat the events array as append-only — VAR-rescinded goals are kept and flagged, not removed.
  • Pull the full match summary on the final whistle for an authoritative snapshot.

Frequently Asked Questions

How fast do live World Cup scores update?

Live scores typically update within seconds of an event in our source feed. The API returns the latest known state on every request — there is no polling delay you have to account for client-side.

Can I get historical World Cup results?

Yes. Match results for every FIFA World Cup edition from 1998 onward are accessible via the same matches endpoint with that edition's season_id (e.g. season_id=sn_326766 for 2022; list them via /football/competitions/${WORLD_CUP_META.competitionIdPlaceholder}/seasons).

What events are returned per match?

Goals, shots, yellow and red cards, substitutions, penalties, and VAR decisions, each with team and player. The timeline is in chronological order and includes injury time in the extra_time field (+1, +2, etc.).

Are penalty shootouts included?

Yes. Knockout-stage penalty shootouts are returned with shooter-by-shooter outcomes in the timeline, plus the shootout score in score.penalty_shootout.

How do I subscribe to live score updates?

Poll /matches?status=live every 5-10 seconds, and /matches/{match_id}/live-timeline for in-play events on the matches you are tracking. There is no webhook push.

Does the API return xG (expected goals) for finished matches?

Yes, where xg_available is true. Team xG is returned by /matches/{match_id}/stats and per-shot xG by /matches/{match_id}/shotmap. See /world-cup/xg for details.

How are forfeits or abandoned matches handled?

Match status is one of scheduled, live, finished, postponed, or cancelled; there is no separate abandoned or forfeit status.

Start building with the World Cup 2026 API

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