WC2026 match-detail intelligence endpoint (lineups, shots+xG, momentum, etc.)
Match meta + Elo prediction + odds + every ingested detail section. Sections are null when that section has not been ingested for this match yet, or came back empty. 60s cache. Every player_id, team_id and match_id inside the sections (lineups, player_match_stats, team_match_stats, best_players, avg_positions, pre_match_form, momentum) is a Big Balls UUID. The recent_match_history and ranked_form_metrics sections are also served: recent_match_history contains each side's recent finished-match sequence, ranked_form_metrics contains each side's ranked, form-derived indicators, and pre_match_form remains the v1 compatibility alias (ranked metrics when present, otherwise recent-match history); their ids are Big Balls UUIDs too. A player_id is null when the player is not yet linked to a player record; player_name is still populated on lineups. Legacy alias: GET /v1/nerd/wc2026/matches/{id} (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.
Request
- Base URL: https://api.bigballsdata.com
- URL: https://api.bigballsdata.com/v1/wc2026/matches/{id}
- Auth: one of:
- API key in header x-api-key
- HTTP bearer
Path parameters
Query parameters
Accepted and IGNORED. No handler reads view; the response is byte-identical with and without it (verified 2026-09-17 against production on /v1/games, /v1/wc2026/matches and /v1/wc2026/standings, modulo meta.cache_age_ms). Kept in the contract, and still tolerated by the routes, only so existing callers that send it are not broken, but do not build on it.
Response
ok
Changes
No recorded changes to this operation across all 3 revisions of this API.