Event

Last updated February 12, 2016

Used by: Events

Name Type Description
event_id string This is the Event ID that is used by MLB Box Score and NBA Box Score
event_status string This value can be scheduled, completed, postponed, suspended, or cancelled. A completed status indicates the game has been processed in the database and its box score is available to download
sport string A value of either NBA or MLB
start_date_time string The scheduled date and time of the event using yyyy‑MM‑DDTHH:mm:ss±hh:mm ISO 8601 format. Some events are scheduled with a "to be determined" time. For these events, a special time value of 03:45:56 using the Eastern Time Zone (ET) is used
season_type string An indicator of the season: pre, regular, post
away_team object Team object
home_team object Team object
site object The Site of the event
away_period_scores array of integers Away team's period (i.e., quarter, inning, etc.) scores. For baseball, when a game ends with fewer than nine innings, -1 is used to indicate an inning where the team did not bat. This value will be populated only when season_type is regular or post and the event_status is completed
home_period_scores array of integers Home team's period (i.e., quarter, inning, etc.) scores. For baseball, when a game ends with fewer than nine innings, -1 is used to indicate an inning where the team did not bat. This value will be populated only when season_type is regular or post and the event_status is completed
away_points_scored integer Number of points away team scored during event. This value will be -1 when event_status is anything other than completed
home_points_scored integer Number of points home team scored during event. This value will be -1 when event_status is anything other than completed

Example Listing

{
  "event_id" : "20150310-cleveland-cavaliers-at-dallas-mavericks",
  "event_status" : "scheduled",
  "sport" : "NBA",
  "start_date_time" : "2015-03-10T17:30:00-07:00",
  "season_type" : "regular",
  "away_team" : {
    "team_id" : "cleveland-cavaliers",
    "abbreviation" : "CLE",
    "active" : true,
    "first_name" : "Cleveland",
    "last_name" : "Cavaliers",
    "conference" : "East",
    "division" : "Central",
    "site_name" : "Quicken Loans Arena",
    "city" : "Cleveland",
    "state" : "Ohio",
    "full_name" : "Cleveland Cavaliers"
  },
  "home_team" : {
    "team_id" : "dallas-mavericks",
    "abbreviation" : "DAL",
    "active" : true,
    "first_name" : "Dallas",
    "last_name" : "Mavericks",
    "conference" : "West",
    "division" : "Southwest",
    "site_name" : "American Airlines Center",
    "city" : "Dallas",
    "state" : "Texas",
    "full_name" : "Dallas Mavericks"
  },
  "site" : {
    "capacity" : 19200,
    "surface" : "Hardwood",
    "name" : "American Airlines Center",
    "state" : "Texas",
    "city" : "Dallas"
  },
  "away_period_scores" : [ ],
  "home_period_scores" : [ ],
  "away_points_scored" : -1,
  "home_points_scored" : -1
}