## How versioning works [#how-versioning-works]

Every response carries `meta.version`. The version bumps only for **breaking** changes —
removing or renaming a field, changing a status-code contract, or altering the envelope shape.
Additive changes (new endpoints, new fields, new error codes) ship without a version bump and
are listed here as `additive`.

## v1 — current [#v1--current]

### 2026-07 · additive [#2026-07--additive]

* Added `/v1/analysis/stat-board` (10× weight, paid tier): slate-wide over-rate board for a
  competition + date + stat, with `recommended` and `full_slate` rankings.

### 2026-05-15 · additive [#2026-05-15--additive]

* Added `/v1/analysis/player-prop` (10× weight, paid tier).
* Added `meta.cache: "HIT" | "MISS" | "STALE"` to every envelope.
* New error code: `NOT_SUPPORTED` (501) for league-capability gaps, with machine-readable
  `league` and `capability` fields.

### 2026-04-02 · additive [#2026-04-02--additive]

* MLB play-by-play with Statcast pitch-level metrics.
* New `detail=sparse|standard|full` query param to trade payload size for field coverage.

### 2026-03-10 · additive [#2026-03-10--additive]

* NFL and NHL added to the normalized schema. NBA and MLB were live previously.
* New endpoints: `/v1/competitions/{comp}/editions/{year}/standings`,
  `/v1/teams/{team_id}/roster`, and `/v1/competitions/{comp}/editions/{year}/games`.

### 2026-02-22 · v1.0 — initial release [#2026-02-22--v10--initial-release]

* REST API with NBA + MLB normalized box scores, season stats, and player search.
* Hosted MCP server at `mcp.statshawk.ai` with OAuth sign-in.
* Plans: free / hobby / pro / scale / growth / enterprise.

## Subscribing [#subscribing]

We post a short note to the [Statshawk blog](https://statshawk.ai/blog) on every change here.
For breaking changes (version bumps) we will also email registered accounts at least 60 days
before cut-over.