FIFA World Cup 2026 (V4)

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 — the first 48-team edition with 104 matches across 12 groups (A–L). V4 ships a dedicated set of World Cup convenience endpoints that hardcode the correct league filter (leagueId = 3) so you don’t have to. They combine match data with bookmaker odds, community predictions, and tournament-specific promotions.

Base URL

https://api.sportsapipro.com/v4/football

All endpoints require the x-api-key header. See Authentication.

League ID: 3. These convenience routes resolve to the same data as the generic /api/v1/league/3/... endpoints — they’re shorter and pre-scoped to the tournament.

Convenience Endpoints

Endpoint	Description	Cache
`GET /api/v1/world-cup`	Combined overview: today’s matches + all 12 group standings + outright markets	2m / 10m
`GET /api/v1/world-cup/matches`	World Cup matches (today by default; `?startDate=&endDate=`)	2m
`GET /api/v1/world-cup/standings`	All 12 group standings (A–L)	10m
`GET /api/v1/world-cup/outrights`	Outright markets: Winner + Group Winner (12 subgroups)	5m
`GET /api/v1/world-cup/predictions`	Today’s matches plus community poll data	2m / 10m
`GET /api/v1/world-cup/special-offers`	Bookmaker promotions + welcome bonuses for the World Cup	1h
`GET /api/v1/world-cup/news`	World Cup betting news (`?page=&perPage=`)	10m

The overview endpoint uses Promise.allSettled internally, so it returns partial data even if one sub-query is briefly unavailable.

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

Sample Response — Overview

{
  "generatedAt": "2026-06-11T16:30:00.000Z",
  "leagueId": 3,
  "leagueName": "World Cup 2026",
  "matches": [
    {
      "id": 9798283,
      "homeTeam": "Mexico",
      "homeTeamId": 6,
      "awayTeam": "South Africa",
      "awayTeamId": 1487,
      "matchDate": "2026-06-11 19:00:00+00",
      "leagueId": 3
    }
  ],
  "totalMatches": 1,
  "standings": {
    "Group A": {
      "total": [
        { "rank": 1, "team_name": "Mexico", "played": "0", "win": "0", "draw": "0", "loss": "0", "points": "0" }
      ]
    }
  },
  "outrights": [
    { "id": 1500, "name": "Winner", "has_handicap": false },
    { "id": 3100, "name": "Group Winner", "has_handicap": true, "subgroups": [{ "name": "Group A" }] }
  ]
}

Example Requests

# Today's WC matches with odds
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.sportsapipro.com/v4/football/world-cup/matches"

# All 12 group standings
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.sportsapipro.com/v4/football/world-cup/standings"

# Outrights (tournament winner + group winners)
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.sportsapipro.com/v4/football/world-cup/outrights"

# Latest WC betting news
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.sportsapipro.com/v4/football/world-cup/news?perPage=10"

Match Detail — odds, line movements, markets, community prediction for any WC match ID.
Leagues & Standings — generic league endpoints (use leagueId = 3 for WC).
FIFA World Cup 2026 (V2) — the parallel V2 dataset (squads, rounds, knockout bracket, real-time scores).

API Reference

Guides

Popular Sports

Team Sports

Racquet & Precision Sports

Specialty Sports

V3 API

V4 Odds API

V6 AiScore API

V1 Legacy

Football V1

Basketball V1

Tennis V1

Hockey V1

FIFA World Cup 2026 (V4)

Overview

Base URL

Convenience Endpoints

Groups

Sample Response — Overview

Example Requests

​Overview

​Base URL

​Convenience Endpoints

​Groups

​Sample Response — Overview

​Example Requests

​Related

Overview

Base URL

Convenience Endpoints

Groups

Sample Response — Overview

Example Requests

Related