Skip to main content

​
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://v4.football.sportsapipro.com
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

EndpointDescriptionCache
GET /api/v1/world-cupCombined overview: today’s matches + all 12 group standings + outright markets2m / 10m
GET /api/v1/world-cup/matchesWorld Cup matches (today by default; ?startDate=&endDate=)2m
GET /api/v1/world-cup/standingsAll 12 group standings (A–L)10m
GET /api/v1/world-cup/outrightsOutright markets: Winner + Group Winner (12 subgroups)5m
GET /api/v1/world-cup/predictionsToday’s matches plus community poll data2m / 10m
GET /api/v1/world-cup/special-offersBookmaker promotions + welcome bonuses for the World Cup1h
GET /api/v1/world-cup/newsWorld 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

GroupTeams
AMexico, South Africa, South Korea, Czechia
BCanada, Bosnia & Herzegovina, Qatar, Switzerland
CBrazil, Morocco, Haiti, Scotland
DUSA, Paraguay, Australia, Türkiye
EGermany, Curaçao, Côte d’Ivoire, Ecuador
FNetherlands, Japan, Sweden, Tunisia
GBelgium, Egypt, Iran, New Zealand
HSpain, Cabo Verde, Saudi Arabia, Uruguay
IFrance, Senegal, Iraq, Norway
JArgentina, Algeria, Austria, Jordan
KPortugal, DR Congo, Uzbekistan, Colombia
LEngland, 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://v4.football.sportsapipro.com/api/v1/world-cup/matches"

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

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

# Latest WC betting news
curl -H "x-api-key: YOUR_API_KEY" \
  "https://v4.football.sportsapipro.com/api/v1/world-cup/news?perPage=10"
Last modified on June 11, 2026