🗃️ historicData

Event Historic Data Object

Per-event box-score stats — what each player and team actually did in a single, completed game. Only available for events whose startTime is in the past. Stats are available the morning after the event; until then both lists are empty.

{
  "players": [
    {
      "player": {
        "id": "PLYR_abc123def456",
        "firstName": "LeBron",
        "lastName": "James",
        "fullName": "LeBron James",
        "sportId": "SPRT_basketball",
        "sportsdataioId": "20000571",
        "oddsjamId": null,
        "sportradarId": null
      },
      "stats": [
        {
          "metric": {
            "id": "METR_points",
            "name": "Points"
          },
          "value": 27
        },
        {
          "metric": {
            "id": "METR_assists",
            "name": "Assists"
          },
          "value": 8
        }
      ]
    }
  ],
  "teams": [
    {
      "team": {
        "id": "TEAM_lakers",
        "name": "Lakers",
        "fullName": "Los Angeles Lakers",
        "abbr": "LAL"
      },
      "stats": [
        {
          "metric": {
            "id": "METR_points",
            "name": "Points"
          },
          "value": 110
        }
      ]
    }
  ]
}

Endpoints

🔎 event historicData detail

Object Structure

The response is an object with two top-level keys: players and teams. Each one is a list of entries pairing an entity with the statistics it recorded in that single game.

players (array)

One entry per player who recorded statistics in the event.

player (object)

The player who recorded these stats. Uses PlayerSerializerLight:

  • id (string) — Player ID with PLYR_ prefix
  • firstName, lastName, fullName (string)
  • sportId (string) — Sport identifier with SPRT_ prefix
  • sportsdataioId, oddsjamId, sportradarId (string|null) — third-party identifiers

stats (array)

Array of {metric, value} rows recorded for this player in this game. Same shape as the player/team historicData stat rows.

teams (array)

One entry per team that recorded team-level statistics in the event.

team (object)

The team. Uses TeamSerializerLight:

  • id (string) — Team ID with TEAM_ prefix
  • name (string) — Short team name (e.g. "Lakers")
  • fullName (string) — Full team name (e.g. "Los Angeles Lakers")
  • abbr (string) — Team abbreviation (e.g. "LAL")

stats (array)

Array of {metric, value} rows recorded for this team in this game (from TeamGameData).