Football · World · National teams
World Cup API with every tournament since 1930
A World Cup API with live scores, group tables, the knockout bracket, line-ups and statistics on league id 195843. All 23 tournaments, from Uruguay 1930 to the 48-team edition of 2026, are in the archive, each one a season of its own.
- 23 tournaments since 1930
- 48 teams · 104 matches in 2026
- League id 195843
- Six qualifying competitions

FIFA World Cup
GET /v2/leagues/195843
- League id
195843- Category
- World
- Archive
- 23 tournaments since 1930
- Teams
- 48 teams in 2026
- Matches
- 104 matches in 2026
- Live channel
league:195843
In the data
The World Cup in the API
What league id 195843 holds, and how its tournaments are laid out.
One season per tournament
/v2/leagues/195843/seasons lists each World Cup as a season, 2026 first. A season's detail names its host nations in hostCountries, three of them for 2026: Canada, Mexico and the USA. The Women's World Cup (league 248653) and the Club World Cup (201238) are separate competitions, each with its own seasons.
Groups, then the bracket
The 2026 tournament opened with 12 groups of four. /standings?group=all returns every group table at once, in the source's order, and /cup-trees holds the knockout stage from the round of 32 to the final, with extra time and shoot-outs inside each tie. Older tournaments keep the format they were played in, and the further back one lies, the more it is results and tables only.
Qualifiers and national teams
Qualifying runs as six competitions of its own, one per confederation: UEFA (201242), CONMEBOL (271420), CONCACAF (271422), CAF (765704), AFC (851276) and OFC (854894), plus the inter-confederation play-off (195847). National teams are teams like any other, with squads and fixtures, and /v2/players/{id}/national-team gives a player's caps, goals and debut for every side they have played for.
Endpoints
The calls behind a World Cup app
Each takes league id 195843, a season id from its seasons list, or a match or team id from those. Every row opens its page in the docs.
- GET
/v2/leagues/{id}/seasonsSeasonsEvery tournament since 1930 as a season, 2026 first.All plans - GET
/v2/leagues/{id}/seasons/{seasonId}SeasonA tournament's totals and its host nations.All plans - GET
/v2/leagues/{id}/standingsStandingsEvery group table of a tournament with group=all.All plans - GET
/v2/leagues/{id}/cup-treesCup treesThe knockout bracket, round of 32 to the final in 2026.All plans - GET
/v2/fixturesFixtures by dateOne day's World Cup matches in a single request.All plans - GET
/v2/fixtures/{id}/lineupsLineupsBoth squads and formations, every player with a rating.All plans - GET
/v2/players/{id}/national-teamNational teamA player's caps, goals and debut for each national side.All plans - GET
/v2/leagues/{id}/top-playersTop playersA tournament's leaderboards: goals, assists, rating and more.Pro and up
First request
The World Cup in three calls
Every call starts from the league id, 195843. The seasons list gives the season ids, newest first, and the season id is what the tables, rounds, leaderboards and statistics ask for.
The answers use the usual { data, meta } envelope and the same field names as every other football competition, so the code works unchanged for the next league you add.
# Every tournament, newest first, with its season id
curl "https://api.datasportsapi.com/v2/leagues/195843/seasons" \
-H "Authorization: Bearer $DATASPORTSAPI_API_KEY"
# Every group table of that tournament
curl "https://api.datasportsapi.com/v2/leagues/195843/standings?season={seasonId}&group=all" \
-H "Authorization: Bearer $DATASPORTSAPI_API_KEY"
# The knockout bracket
curl "https://api.datasportsapi.com/v2/leagues/195843/cup-trees?season={seasonId}" \
-H "Authorization: Bearer $DATASPORTSAPI_API_KEY"{ "data": {
"id": 195843, "name": "FIFA World Cup", "sport": "football",
"category": "World", "country": null,
"tier": null, "gender": "male",
…
} }History
How much of the World Cup each plan reads
The archive goes back to 1930. Each plan reads back a set time from today; nothing live or upcoming is ever held back.
| Topic | History | What it covers of the World Cup |
|---|---|---|
| Free | Last 7 days | Live and upcoming matches, the table and statistics of a tournament still being played, and finished matches from the last 7 days. |
| Starter | Last 30 days | Live and upcoming matches, the table and statistics of a tournament still being played, and finished matches from the last 30 days. |
| Pro | Last 6 months | Live and upcoming matches, the table and statistics of a tournament still being played, and finished matches from the last 6 months. |
| Business | Last 12 months | Live and upcoming matches, the table and statistics of a tournament still being played, and finished matches from the last 12 months. |
| Enterprise | Full history | The whole archive: 23 tournaments since 1930. |
Questions
World Cup API, answered
Anything else? The full FAQ covers quota, plans and the data in general.
Does the API cover the 2026 World Cup?
Yes, in full: 48 teams, 12 group tables and 104 matches, with line-ups, events, statistics and shot maps for the matches, and the bracket from the round of 32 to the final. The season's detail lists Canada, Mexico and the USA as hosts.
Are the World Cup qualifiers included?
Yes, as six competitions of their own, one per confederation, plus the inter-confederation play-off. Their ids are on this page, and /v2/search?q=world cup qual finds them by name.
Is the Women's World Cup covered too?
Yes. The FIFA Women's World Cup is league 248653, with its own seasons, groups and bracket, and it answers in exactly the same shape, so code written for one tournament works for the other.
How far back does World Cup data go?
To 1930: all 23 tournaments are in the archive. How far back a key can read is set by its plan, counted back from today: Free 7 days, Starter 30 days, Pro 6 months, Business 12 months, and Enterprise the whole archive. Live and upcoming matches, and the table and statistics of a season still being played, are open on every plan.
Can I follow World Cup matches live on the free plan?
Yes. Live and upcoming matches are never held back by a plan, so a Free key follows every World Cup match in play through /v2/livescores or /v2/fixtures/{id}, with score, status and clock current to the second, within the plan's request quota. On Business and Enterprise, the WebSocket channel league:195843 pushes every change instead.
Keep reading
Other competitions
Premier League APILeague id 195828: live scores, the table, xG and every season since 1992/93.
Champions League APILeague id 4409: the 36-club league phase, the knockout bracket and every season since 1992/93.
La Liga APILeague id 4408: Spain's top flight, head-to-head records and every season since 1969/70.
Serie A APILeague id 195910: Italy's top flight, venues and the longest big-five archive, back to 1965/66.
Bundesliga APILeague id 195937: Germany's 18 clubs, the team of the week and every season since 1970/71.
Ligue 1 APILeague id 195793: France's top flight, every player's statistics and seasons since 1970/71.
Süper Lig APILeague id 172801: Turkey's top division, its referees on record and seasons back to 1980/81.
MLS APILeague id 6540: 30 clubs, two conference tables and calendar-year seasons since 2008.
Europa League APILeague id 43443: one 36-club table, knockout ties on aggregate and seasons since 2009/10.
NBA APILeague id 198277: box scores, play-by-play, shot charts, the draft and live player tracking.
NFL APILeague id 201295: down and distance live, win probability, the draft and seasons back to 1920.
NHL APILeague id 201302: conference and division tables, shot maps by strength, the three stars and playoff series.
MLB APILeague id 201220: the live count, every at-bat and pitch, umpire crews and ballpark weather.
IPL APILeague id 195830: full scorecards, every ball with wagon wheel and pitch map, and seasons since 2013.
Everything in the football data Sports statistics API Live scores API
Build on the World Cup today.
1,000 free requests a day during the beta. No card, no sales call.