> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sportsapipro.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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

```text theme={null}
GET /api/v1/world-cup/matches?tz=00:00
```

Returns **104 matches** (group stage + knockout).

<CodeGroup>
  ```bash New canonical theme={null}
  curl -H "x-api-key: YOUR_API_KEY" \
    "https://api.sportsapipro.com/v6/football/world-cup/matches"
  ```

  ```bash Classic theme={null}
  curl -H "x-api-key: YOUR_API_KEY" \
    "https://api.sportsapipro.com/v6/football/world-cup/matches"
  ```
</CodeGroup>

<Tip>
  Call [`/match/{id}`](/api-reference/v6-aiscore/match-detail) on any returned `matches[].id` to hydrate team names, venue, and animation widget.
</Tip>

## Group Tables

```text theme={null}
GET /api/v1/world-cup/groups
```

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

```json theme={null}
{
  "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)

```bash theme={null}
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

```json theme={null}
{
  "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.