---
title: "The player-prop board as it stood at an instant"
method: GET
path: "/v1/as-of/player-props"
tags: ["as-of"]
---

# The player-prop board as it stood at an instant

`GET /v1/as-of/player-props`

## Request

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

The deep point-in-time relation. One row per book, market, player, outcome and line as last observed at or before `as_of`, each carrying its `observed_at` instant and whether that was before kickoff.

This is the surface for reconstructing what was known before a game started. Measured on 2026-10-12 the archive spans 2023-05 to 2026-10 and is continuous within each season, with the offseason correctly absent in every year. Those offseason months are reported as gaps and an `as_of` inside one is refused rather than answered with an empty list.

ADDRESSED BY OUR OWN `match_id`, never by an upstream identifier, which is the same addressing `/v1/odds/player-props/historical` uses, so one id works across both routes. A match that cannot be resolved to exactly one archived game is a 404 rather than a guess.

DEPTH HERE IS NOT THE DEPTH OF `/v1/as-of/odds`. Call `/v1/as-of/coverage?relation=player_props` for this relation's own windows; the two are never blended.

## Query parameters

- `as_of` string, date-time, required
- `match_id` string, uuid, required

## Response `200`

ok. `{ data, meta }`, with `meta.as_of_floor`, `meta.as_of_ceiling` and `meta.empty_means`.

## Other responses

- `400`: invalid or missing as_of/match_id
- `403`: plan_required (Edge or higher)
- `404`: that match has no point-in-time prop coverage
- `422`: unprocessable: no point-in-time record exists for that instant. Names as_of_floor, as_of_ceiling and gaps.
- `503`: the coverage windows are still being built

---

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