---
title: "All 72 WC2026 group-stage matches with Elo prediction + odds"
method: GET
path: "/v1/wc2026/matches"
tags: ["nerd"]
---

# All 72 WC2026 group-stage matches with Elo prediction + odds

`GET /v1/wc2026/matches`

## Request

- Base URL: `https://api.bigballsdata.com`
- URL: `https://api.bigballsdata.com/v1/wc2026/matches`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Filterable by group (A-L) and status (upcoming/live/final). Odds null
until the upstream odds feed activates the tournament. 5-min cache.
Legacy alias: `GET /v1/nerd/wc2026/matches` (sunset 2026-09-01).

`elo_prediction` carries its own freshness: `valid_until`, `expired`
(true / false / null when no expiry is stated) and `expired_days`.
Measured 2026-09-28, all 72 `match_result` predictions are past their
valid_until, the newest by 92 days, and these routes previously carried
no expiry at all; so the block read as a forecast for a match already
played. Nothing is filtered; the block is disclosed, not withheld.

## Query parameters

- `group` string
- `status` 'upcoming' | 'live' | 'final'
- `date` string
- `tz` string
- `view` 'nerd'

## Response `200`

ok

- object

## Other responses

- `400`: invalid query

---

[API](https://skmtc.dev/bigballsdata/apis/big-ball-sports-api.md) · [All operations](https://skmtc.dev/bigballsdata/apis/big-ball-sports-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bigballsdata/apis/big-ball-sports-api/revisions/31fb54ac414e?raw)