> ## 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.

# FIFA World Cup 2026 (V1)

> Dedicated V1 convenience endpoints for the FIFA World Cup 2026: 48 teams, 12 groups, 104 matches across USA, Canada, and Mexico

## Overview

The FIFA World Cup 2026 runs across the United States, Canada, and Mexico from **June 11, 2026** (Mexico vs South Africa) through the Final. It is the first 48-team edition, with **104 matches** played across **12 groups (A–L)**.

V1 ships a dedicated set of World Cup convenience endpoints that hardcode the correct competition filter so you don't have to look up IDs. They combine match data, group standings, knockout brackets, fan prediction polls, and tournament news in single calls.

## Base URL

```
https://api.sportsapipro.com/v1/football
```

All endpoints require the `x-api-key` header. See [Authentication](/authentication).

<Info>
  **Underlying canonical ID** — `competitionId = 5930`. These convenience routes resolve to the same data as the generic `/api/v1/competition/5930/...` endpoints; they're shorter and pre-scoped to the tournament.
</Info>

## Convenience Endpoints

| Endpoint                                          | Description                                                                     |
| ------------------------------------------------- | ------------------------------------------------------------------------------- |
| `GET /api/v1/world-cup`                           | Combined overview: games + group standings + knockout brackets (parallel fetch) |
| `GET /api/v1/world-cup/matches`                   | All World Cup matches (scheduled, live, and completed)                          |
| `GET /api/v1/world-cup/results`                   | Completed matches only                                                          |
| `GET /api/v1/world-cup/standings`                 | All 12 group tables (optional `?seasonNum=25`)                                  |
| `GET /api/v1/world-cup/brackets`                  | Knockout bracket; populates as the tournament progresses                        |
| `GET /api/v1/world-cup/stats`                     | Top scorers, assists, cards, and team statistics                                |
| `GET /api/v1/world-cup/news`                      | Tournament news articles                                                        |
| `GET /api/v1/world-cup/odds`                      | Fan prediction polls (winner, totals) for upcoming matches                      |
| `GET /api/v1/world-cup/insights`                  | Combined predictions + tournament stats overview                                |
| `GET /api/v1/world-cup/history`                   | Past season standings and tournament history                                    |
| `GET /api/v1/world-cup/transfers`                 | Player transfers related to World Cup teams                                     |
| `GET /api/v1/world-cup/game/{gameId}`             | Full match detail (events, lineups, venue, officials)                           |
| `GET /api/v1/world-cup/game/{gameId}/events`      | Goals, cards, substitutions                                                     |
| `GET /api/v1/world-cup/game/{gameId}/lineups`     | Starting XI + bench for both teams                                              |
| `GET /api/v1/world-cup/game/{gameId}/stats`       | Per-player match statistics                                                     |
| `GET /api/v1/world-cup/game/{gameId}/predictions` | Fan voting predictions                                                          |
| `GET /api/v1/world-cup/game/{gameId}/playbyplay`  | Live commentary feed                                                            |

<Note>Responses follow the standard V1 schema. Match kickoff times are ISO 8601 strings (`startTime`). The overview endpoint returns partial data if a sub-query is briefly unavailable.</Note>

## Groups

| Group | Teams                                            |
| ----- | ------------------------------------------------ |
| A     | Mexico, South Africa, South Korea, Czechia       |
| B     | Canada, Bosnia & Herzegovina, Qatar, Switzerland |
| C     | Brazil, Morocco, Haiti, Scotland                 |
| D     | USA, Paraguay, Australia, Türkiye                |
| E     | Germany, Curaçao, Côte d'Ivoire, Ecuador         |
| F     | Netherlands, Japan, Sweden, Tunisia              |
| G     | Belgium, Egypt, Iran, New Zealand                |
| H     | Spain, Cabo Verde, Saudi Arabia, Uruguay         |
| I     | France, Senegal, Iraq, Norway                    |
| J     | Argentina, Algeria, Austria, Jordan              |
| K     | Portugal, DR Congo, Uzbekistan, Colombia         |
| L     | England, Croatia, Ghana, Panama                  |

## Example: Matches

```bash theme={null}
curl -X GET "https://api.sportsapipro.com/v1/world-cup/matches" \
  -H "x-api-key: YOUR_API_KEY"
```

```json theme={null}
{
  "success": true,
  "type": "world-cup-matches",
  "competitionId": 5930,
  "data": {
    "games": [
      {
        "id": 4697696,
        "competitionId": 5930,
        "startTime": "2026-06-12T02:00:00Z",
        "statusGroup": 4,
        "statusText": "Ended",
        "homeCompetitor": { "id": 5040, "name": "South Korea", "score": 2 },
        "awayCompetitor": { "id": 2383, "name": "Czechia", "score": 1 },
        "venue": { "name": "MetLife Stadium", "city": "East Rutherford" }
      }
    ],
    "competitions": [],
    "countries": []
  }
}
```

## Example: Standings

```json theme={null}
{
  "success": true,
  "type": "world-cup-standings",
  "data": {
    "standings": [
      {
        "competitionId": 5930,
        "seasonNum": 25,
        "rows": [
          {
            "position": 1,
            "competitor": { "id": 5040, "name": "South Korea" },
            "gamePlayed": 1,
            "wins": 1,
            "draws": 0,
            "losses": 0,
            "goalsFor": 2,
            "goalsAgainst": 1,
            "points": 3,
            "group": { "name": "Group H" }
          }
        ]
      }
    ]
  }
}
```

## Example: Fan Prediction Odds

```json theme={null}
{
  "success": true,
  "type": "world-cup-odds",
  "data": {
    "games": [
      {
        "gameId": 4697699,
        "homeTeam": "Canada",
        "awayTeam": "Bosnia & Herzegovina",
        "startTime": "2026-06-12T19:00:00Z",
        "statusText": "Scheduled",
        "predictions": {
          "predictions": [
            {
              "title": "Who Will Win?",
              "totalVotes": 65237,
              "options": [
                { "name": "Canada", "vote": { "percentage": 73 } },
                { "name": "Draw", "vote": { "percentage": 11 } },
                { "name": "Bosnia & Herzegovina", "vote": { "percentage": 16 } }
              ]
            },
            {
              "title": "Total Goals In Match (2.5)",
              "options": [
                { "name": "Under", "vote": { "percentage": 48 } },
                { "name": "Over", "vote": { "percentage": 52 } }
              ]
            }
          ]
        }
      }
    ],
    "totalGames": 1
  }
}
```

## Integration Tips

1. **Landing page** — call `/api/v1/world-cup` once for a tournament hub (games + standings + brackets in parallel).
2. **Live ticker** — filter `/api/v1/world-cup/matches` by `statusGroup === 3` (in-progress).
3. **Group tables** — render `/api/v1/world-cup/standings`; each group is a `rows` array sorted by `position`.
4. **Fan engagement** — display `/api/v1/world-cup/odds` vote percentages as progress bars.
5. **Match detail** — `/api/v1/world-cup/game/{id}` returns venue, lineups, events, and live commentary.
6. **Real-time updates** — pair REST data with the [V1 WebSocket](/api-reference/v1-legacy/websocket) for sub-second score deltas during matches.

## Managers & Venues

V1 exposes full venue detail on game detail, and a partial coach signal on lineups (ID only, no name).

### Venue (full detail with attendance)

`GET /api/v1/game/{gameId}` returns a complete `venue` object — including live `attendance` once the gate count is published.

```json theme={null}
{
  "venue": {
    "id": 8248,
    "name": "Estadio AKRON (Guadalajara)",
    "shortName": "estadio-akron-(guadalajara)",
    "capacity": 49850,
    "attendance": 44985
  }
}
```

### Manager / Coach (partial — ID only)

Coaches surface in `GET /api/v1/game/{gameId}/lineups` as the last entry in each team's `members[]` array. The marker is `formation.name === "Coach"` with `status: 4` and `statusText: "Management"`.

```json theme={null}
{
  "status": 4,
  "statusText": "Management",
  "position": { "id": 0, "name": "Management" },
  "formation": { "id": 16, "name": "Coach", "shortName": "Coach" },
  "id": 515052
}
```

<Warning>
  V1 does not return a coach **name** — only an athlete `id`. The `/api/v1/competitor/{id}` endpoint also does not expose a coach field. If you need the coach's name, country, or career, use the V2 team detail endpoint (see recommendation below).
</Warning>

### Cross-version recommendation

| Data                               | Best version | Endpoint                            | Field                                          |
| ---------------------------------- | ------------ | ----------------------------------- | ---------------------------------------------- |
| Manager (name, country, id)        | V2           | `GET /api/teams/{teamId}`           | `data.team.manager`                            |
| Team home venue                    | V2           | `GET /api/teams/{teamId}`           | `data.team.venue`                              |
| Match venue (with coordinates)     | V2           | `GET /api/world-cup-2026/matches`   | `events[].venue`                               |
| Match venue (with live attendance) | V1           | `GET /api/v1/game/{gameId}`         | `venue`                                        |
| Coach ID only                      | V1           | `GET /api/v1/game/{gameId}/lineups` | `members[]` where `formation.name === "Coach"` |

V2's `/api/teams/{teamId}` is the single richest call: manager (with full name) plus home venue (with coordinates and capacity) in one response. See [V2 World Cup — Managers & Venues](/api-reference/football-v2/world-cup-2026#managers-venues).

## Related

* [V1 API Overview](/api-reference/v1-legacy/overview)
* [V1 REST Endpoints](/api-reference/v1-legacy/endpoints) — generic competition/game routes (use `competitionId=5930`)
* [V1 WebSocket](/api-reference/v1-legacy/websocket) — real-time score updates
* [World Cup 2026 (V2)](/api-reference/football-v2/world-cup-2026) — same tournament via the V2 schema
* [World Cup 2026 (V4 Odds)](/api-reference/v4-odds/world-cup-2026) — bookmaker odds and outrights