---
title: "Availability designations as they stood at an instant"
method: GET
path: "/v1/as-of/injuries"
tags: ["as-of"]
---

# Availability designations as they stood at an instant

`GET /v1/as-of/injuries`

## Request

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

The availability designations in force at `as_of`, one row per athlete, each as an interval with the instant we observed it.

FORWARD-ONLY, AND THAT IS A CORRECTNESS LIMIT RATHER THAN A SCOPE ONE. Before this log existed we kept one row per athlete and overwrote it, so the prior states were not retained and cannot be reconstructed. The log therefore has a floor: the instant observation began. An `as_of` below it is refused, never answered. `meta.floor_means` says so in every response.

`change_kind` keeps three states apart that a caller must be able to distinguish: `seeded` is the state when observation began, so anything earlier is UNKNOWN rather than absent; `listed` and `revised` are observed designations; `withdrawn` means the athlete is no longer listed, with no designation attached, which is how a recovery reaches you.

`open_interval: true` means no end was OBSERVED. It is deliberately not called "current": the two differ the moment publishing stops, and `observed_at` lets you see how old the designation is.

## Query parameters

- `as_of` string, date-time, required
- `sport` 'football' | 'basketball' | 'baseball' | 'ice_hockey' | 'cricket' | 'mma' | 'boxing' | 'formula1' | 'american_football', required

## Response `200`

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

## Other responses

- `400`: invalid or missing as_of/sport
- `403`: plan_required (Edge or higher)
- `422`: unprocessable: no point-in-time record exists for that instant, typically an as_of before observation began. Names as_of_floor and as_of_ceiling.
- `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)