🗃️ historicData

Player Historic Data Object

[
  {
    "event": {
      "id": "EVNT_47c18807ebc0429e8dd0335203a62373",
      "sport": {
        "id": "SPRT_americanfootball",
        "name": "American Football"
      },
      "league": {
        "id": "LGUE_nfl",
        "name": "NFL",
        "abbr": "NFL"
      },
      "name": "Dallas Cowboys @ Philadelphia Eagles",
      "nameSpecial": null,
      "startTime": "2024-01-15T01:00:00Z",
      "sportId": "SPRT_americanfootball",
      "leagueId": "LGUE_nfl"
    },
    "stats": [
      {
        "metric": {
          "id": "METR_passing_yards",
          "name": "Passing Yards"
        },
        "value": 312
      },
      {
        "metric": {
          "id": "METR_passing_touchdowns",
          "name": "Passing Touchdowns"
        },
        "value": 2
      },
      {
        "metric": {
          "id": "METR_passing_attempts",
          "name": "Passing Attempts"
        },
        "value": 45
      },
      {
        "metric": {
          "id": "METR_completions",
          "name": "Completions"
        },
        "value": 28
      }
    ]
  },
  {
    "event": {
      "id": "EVNT_23b9856f7a2c4d1e89f0124578c93456",
      "sport": {
        "id": "SPRT_americanfootball",
        "name": "American Football"
      },
      "league": {
        "id": "LGUE_nfl",
        "name": "NFL",
        "abbr": "NFL"
      },
      "name": "Philadelphia Eagles @ New York Giants",
      "nameSpecial": null,
      "startTime": "2024-01-08T18:00:00Z",
      "sportId": "SPRT_americanfootball",
      "leagueId": "LGUE_nfl"
    },
    "stats": [
      {
        "metric": {
          "id": "METR_passing_yards",
          "name": "Passing Yards"
        },
        "value": 289
      },
      {
        "metric": {
          "id": "METR_passing_touchdowns",
          "name": "Passing Touchdowns"
        },
        "value": 3
      },
      {
        "metric": {
          "id": "METR_passing_attempts",
          "name": "Passing Attempts"
        },
        "value": 38
      },
      {
        "metric": {
          "id": "METR_completions",
          "name": "Completions"
        },
        "value": 25
      }
    ]
  },
  {
    "event": {
      "id": "EVNT_89c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7",
      "sport": {
        "id": "SPRT_americanfootball",
        "name": "American Football"
      },
      "league": {
        "id": "LGUE_nfl",
        "name": "NFL",
        "abbr": "NFL"
      },
      "name": "Philadelphia Eagles @ Washington Commanders",
      "nameSpecial": null,
      "startTime": "2024-01-01T20:30:00Z",
      "sportId": "SPRT_americanfootball",
      "leagueId": "LGUE_nfl"
    },
    "stats": [
      {
        "metric": {
          "id": "METR_passing_yards",
          "name": "Passing Yards"
        },
        "value": 256
      },
      {
        "metric": {
          "id": "METR_passing_touchdowns",
          "name": "Passing Touchdowns"
        },
        "value": 1
      },
      {
        "metric": {
          "id": "METR_passing_attempts",
          "name": "Passing Attempts"
        },
        "value": 32
      },
      {
        "metric": {
          "id": "METR_completions",
          "name": "Completions"
        },
        "value": 22
      }
    ]
  }
]

Endpoints

📈 player historic data

Array Structure

The response is an array of event objects, where each object represents a game/event the player participated in, ordered chronologically by start time (most recent first).

Event Object

Each event in the array contains the game details and all statistical metrics recorded for the player in that specific game.

event (object)

Game/event details where the player's statistics were recorded.

id (string)

Unique identifier for the event with format EVNT_*.

sport (object)

Sport information including ID and name.

league (object)

League information including ID, name, and abbreviation.

name (string)

Event name in format "Away Team @ Home Team".

nameSpecial (string|null)

Special event designation (e.g., playoff game names) or null for regular games.

startTime (string)

ISO 8601 formatted start time when this game was played.

sportId (string)

Sport identifier with format SPRT_*.

leagueId (string)

League identifier with format LGUE_*.


stats (array)

Array of all statistical metrics recorded for the player in this specific game/event.

Stat Object Structure

Each stat object in the array contains a metric definition and the player's actual performance value.

metric (object)

Statistical category information.

id (string)

Unique metric identifier with format METR_*.

name (string)

Human-readable metric name (e.g., "Passing Yards", "Rushing Touchdowns").

value (number)

Player's actual statistical performance for this metric in this specific game.