---
title: "WC2026 match-detail intelligence endpoint (lineups, shots+xG, momentum, etc.)"
method: GET
path: "/v1/wc2026/matches/{id}"
tags: ["nerd"]
---

# WC2026 match-detail intelligence endpoint (lineups, shots+xG, momentum, etc.)

`GET /v1/wc2026/matches/{id}`

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

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.

## Path parameters

- `id` string, uuid, required

## Query parameters

- `view` 'nerd'

## Response `200`

ok

- object
  - `data` object
    - `recent_match_history` object, nullable: Home and away recent finished-match history.
    - `ranked_form_metrics` object, nullable: Home and away ranked form-derived metrics.
    - `pre_match_form` object, nullable: Compatibility alias. Ranked form metrics when available, otherwise recent match history.

## Other responses

- `400`: invalid game_id
- `404`: match not found

---

[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)