---
title: "Latest prediction for a match"
method: GET
path: "/v1/predictions/{id}"
tags: ["nerd"]
---

# Latest prediction for a match

`GET /v1/predictions/{id}`

## Request

- Base URL: `https://api.bigballsdata.com`
- URL: `https://api.bigballsdata.com/v1/predictions/{id}`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Solo or higher. The path id is a match UUID from /v1/matches, not a
prediction row id. Returns the newest stored prediction for that match
and its freshness metadata. Predictions can be expired; check
`data.valid_until` and `data.expired` before using one as a forecast.
The response is identical to /v1/predictions/match/{id}.

## Path parameters

- `id` string, uuid, required

## Response `200`

Latest prediction

- SingleMatchPredictionResponse
  - `data` SingleMatchPrediction, required: Latest stored prediction for one match. Check valid_until and expired before use.
    - `match_id` string, uuid, required
    - `prediction_type` 'match_result' | 'value_prop', required
    - `home_team` string, nullable
    - `away_team` string, nullable
    - `home_win_probability` number, nullable
    - `draw_probability` number, nullable
    - `away_win_probability` number, nullable
    - `home_elo` number, nullable
    - `away_elo` number, nullable
    - `model_version` string, required
    - `confidence` number, nullable
    - `valid_until` string, date-time, nullable, required
    - `expired` boolean, nullable, required: Null means the prediction has no stated expiry.
    - `expired_days` number, nullable
    - `generated_at` string, date-time, required
    - `kickoff_utc` string, date-time, nullable
    - `group` string, nullable
    - `value_bet` boolean, nullable
    - `best_side` string, nullable
    - `elo_prob` number, nullable
    - `market_prob` number, nullable
    - `edge` number, nullable
  - `meta` object, required
    - `returned` 1, required
    - `expired` integer, required
    - `expiry_unknown` integer, required
    - `as_of` string, date-time, required
    - `stale` boolean: Present when the prediction is expired.
    - `message` string: Present when the prediction is expired.

## Other responses

- `400`: Invalid match id.
- `403`: Solo plan or covered-sport entitlement required.
- `404`: No prediction stored for this match.

---

[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/9191fc13fcdb?raw)