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 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.
/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.
comp_6107FIFA World Cup (all editions)
sn_118868World Cup 2026
// 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 eventsWhat the World Cup 2026 results API returns
Selected fields from the JSON response. Full schema and example payloads are in the developer docs.
| Field | Type | Description |
|---|---|---|
| status | string | scheduled | live | finished | postponed | cancelled. |
| score | object | { home, away, regulation, after_extra_time, penalty_shootout, went_to_extra_time, went_to_penalties, winner }. |
| events | array | From /timeline: goal | yellow_card | red_card | substitution | penalty_* | var and more. |
| minute | integer | Match minute of the event. |
| extra_time | integer | Stoppage minutes on top of minute (45+2 = minute 45, extra_time 2). |
| player | object | Player for the event (scorer, booked player, etc.). |
| period | string | first_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.