The Statshawk REST API is normalized across NBA, MLB, NFL, NHL, KBO, NCAA, and major soccer competitions. One key, source-agnostic ids, and one shape per concept: persons, teams, competitions, editions, contests, analysis, and assets.

## Conventions [#conventions]

* **Base URL:** `https://api.statshawk.ai`
* **Auth:** `X-API-Key: sk_live_...` header — see [Authentication](/docs/getting-started/auth)
* **Response envelope:** every endpoint returns `{ "data": ..., "meta": { request_id, fetched_at, cache, version } }`
* **Errors:** `{ "error": { "code": "...", "message": "..." } }` — see [Errors](/docs/getting-started/errors)
* **Quotas:** unit-based, not per-second — see [Quotas](/docs/getting-started/quotas)

## Try it from the docs [#try-it-from-the-docs]

Every endpoint page has a built-in playground. Sign in and your key prefix surfaces in a banner above the playground; paste the full key once and run requests directly from the docs.

## Browse by tag [#browse-by-tag]

Use the sidebar to navigate by tag (Persons, Teams, Competitions, Contests, Analysis, Assets). Each tag groups the endpoints that share a resource shape.