World Cup 2026

All 104 matches, 13 group tables, complete historical archive 1930-2026

V6 ships dedicated World Cup 2026 endpoints. Use them for groups, brackets, historical winners, past-edition archives, and tournament-wide player & team stats.

All WC Matches

GET /api/v1/world-cup/matches?tz=00:00

Returns 104 matches (group stage + knockout).

New canonical

curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.sportsapipro.com/v6/football/world-cup/matches"

Call /match/{id} on any returned matches[].id to hydrate team names, venue, and animation widget.

Group Tables

GET /api/v1/world-cup/groups

Returns 13 tables (12 groups A–L + knockout bracket).

{
  "success": true,
  "tables": [
    {
      "name": "A",
      "rows": [
        {
          "team": { "id": "...", "name": "Mexico", "logo": "..." },
          "detail": { "1": "3", "2": "2", "3": "1", "7": "6", "8": "3", "10": "7" }
        }
      ]
    }
  ]
}

Standings keys: 1 Played · 2 W · 3 D · 4 L · 7 GF · 8 GA · 9 GD · 10 Points.

Teams, Stats & Past Editions

Endpoint	Description
GET /api/v1/world-cup/teams	All participating teams
GET /api/v1/world-cup/stats	Tournament player & team stats
GET /api/v1/world-cup/stats?season_id={id}	Stats for a past edition (e.g. 2022)
GET /api/v1/world-cup/home	Full historical overview — 22 editions, winners, hosts, players
GET /api/v1/world-cup/history	Recent 5 editions with results & top teams
GET /api/v1/world-cup/winners	Recent 5 editions with final scores
GET /api/v1/world-cup/seasons	All 23 seasons (1930-2026) with IDs
GET /api/v1/world-cup/archive/{seasonId}	Full competition detail for any past WC

Example — Past Edition Detail (2022)

curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.sportsapipro.com/v6/football/world-cup/archive/w69759i44zc4k23"

Verified: 2022 WC → 35 teams, 64 matches, 6 stages, 8 venues, 18 players.

/world-cup/home Response

{
  "success": true,
  "editions": [
    { "name": "Qatar FIFA World Cup", "year": "2022", "seasonId": "w69759i44zc4k23" }
  ],
  "history": [
    {
      "edition": 22, "year": "2022", "host": "Qatar",
      "winner":     { "id": "8vmqy9i232b4k9r", "name": "Argentina" },
      "runnerUp":   { "id": "mo07dnipzvi9knx", "name": "France" },
      "thirdPlace": { "id": "8vmqy9i1pyc4k9r", "name": "Croatia" },
      "fourthPlace":{ "id": "59gklzixr3b17xd", "name": "Morocco" }
    }
  ],
  "topScorerCategories": [
    { "type": 1, "name": "Golden Ball" },
    { "type": 2, "name": "Golden Boot" },
    { "type": 3, "name": "Golden Glove" }
  ]
}

Cache TTL: 10 minutes for all WC endpoints.