---
title: "What the NHL player-prop archive holds, per season"
method: GET
path: "/v1/odds/player-props/coverage"
tags: ["odds"]
---

# What the NHL player-prop archive holds, per season

`GET /v1/odds/player-props/coverage`

## Request

- Base URL: `https://api.bigballsdata.com`
- URL: `https://api.bigballsdata.com/v1/odds/player-props/coverage`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Per-season depth of the NHL player-prop archive: events held, events
carrying props, and observation counts. Edge plan or higher.

`observations` is the per-event insert count recorded at capture time,
summed; stated in `meta.observations_source` rather than left for you
to assume, because it is not a live `COUNT(*)` over the observation
table.

Response: `{ data: { sport, league, seasons: [{ season, events,
events_with_props, observations, first_event, last_event }], totals,
markets_swept, canonical_markets, market_types }, meta: {
observations_source, snapshot_labels, generated_at } }`.

## Response `200`

ok

## Other responses

- `403`: plan_required (Edge or higher)

---

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