Skip to content

Livematches in play

Demo: Matchboard, opens in a new tab

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.

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"
GET /v2/leagues/195843 · trimmed
{ "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.

TopicHistoryWhat it covers of the World Cup
FreeLast 7 daysLive and upcoming matches, the table and statistics of a tournament still being played, and finished matches from the last 7 days.
StarterLast 30 daysLive and upcoming matches, the table and statistics of a tournament still being played, and finished matches from the last 30 days.
ProLast 6 monthsLive and upcoming matches, the table and statistics of a tournament still being played, and finished matches from the last 6 months.
BusinessLast 12 monthsLive and upcoming matches, the table and statistics of a tournament still being played, and finished matches from the last 12 months.
EnterpriseFull historyThe 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

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.