Changelog

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

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

• 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

• 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

• 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

• 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

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