NBA Box Score

Last updated February 12, 2016

This endpoint returns the box score for an NBA game. Box scores are available for regular and postseason games.

The recommended way of downloading box scores is in conjunction with the Events endpoint. For each Event, check its event_status for completed and season_type for either regular or post. When these values are true, the box score is available to download.

get events
for each event in events:
    if event_status is completed and season_type is regular or post:
        get box score

URL

GET /sport/boxscore/event_id.format

Sport

  1. nba

Event ID

The event_id is a string that uniquely identifies a box score. The format is yyyyMMdd-awayTeamId-at-homeTeamId.

The team_id is the full name of the team, all lowercase with spaces replaced by dashes (e.g., milwaukee‑bucks, new‑orleans‑pelicans). Use the Teams endpoint to view all team_id values.

You can also find the event_id for every box score by using the Events endpoint.

Format

Authorization

Required. A valid access token must be included in the header of the request.

Parameters

None.

Returned Values

Name Type Description
away_team object Team object
home_team object Team object
away_period_scores array of integers Away team's period scores
home_period_scores array of integers Home team's period scores
away_stats array of objects Basketball Stats objects
home_stats array of objects Basketball Stats objects
officials array of objects An array of Official objects
event_information object Event Information object
away_totals object Away team's cumulative Basketball Stats totals
home_totals object Home team's cumulative Basketball Stats totals

Example Request

curl -H "Authorization: Bearer ACCESS_TOKEN" https://erikberg.com/nba/boxscore/20120621-oklahoma-city-thunder-at-miami-heat.json

Example Result

{
  "away_team" : {
    "team_id" : "oklahoma-city-thunder",
    "abbreviation" : "OKC",
    "active" : true,
    "first_name" : "Oklahoma City",
    "last_name" : "Thunder",
    "conference" : "West",
    "division" : "Northwest",
    "site_name" : "Chesapeake Energy Arena",
    "city" : "Oklahoma City",
    "state" : "Oklahoma",
    "full_name" : "Oklahoma City Thunder"
  },
  "home_team" : {
    "team_id" : "miami-heat",
    "abbreviation" : "MIA",
    "active" : true,
    "first_name" : "Miami",
    "last_name" : "Heat",
    "conference" : "East",
    "division" : "Southeast",
    "site_name" : "AmericanAirlines Arena",
    "city" : "Miami",
    "state" : "Florida",
    "full_name" : "Miami Heat"
  },
  "away_period_scores" : [ 26, 23, 22, 35 ],
  "home_period_scores" : [ 31, 28, 36, 26 ],
  "away_stats" : [ {
    "last_name" : "Durant",
    "first_name" : "Kevin",
    "display_name" : "Kevin Durant",
    "position" : "SF",
    "minutes" : 43,
    "points" : 32,
    "assists" : 3,
    "turnovers" : 7,
    "steals" : 2,
    "blocks" : 1,
    "field_goals_attempted" : 24,
    "field_goals_made" : 13,
    "three_point_field_goals_attempted" : 6,
    "three_point_field_goals_made" : 3,
    "free_throws_attempted" : 3,
    "free_throws_made" : 3,
    "defensive_rebounds" : 9,
    "offensive_rebounds" : 2,
    "personal_fouls" : 5,
    "team_abbreviation" : "OKC",
    "is_starter" : true,
    "field_goal_percentage" : 0.542,
    "three_point_percentage" : 0.5,
    "free_throw_percentage" : 1.0
  }, {
    "last_name" : "Westbrook",
    "first_name" : "Russell",
    "display_name" : "Russell Westbrook",
    "position" : "PG",
    "minutes" : 43,
    "points" : 19,
    "assists" : 6,
    "turnovers" : 2,
    "steals" : 2,
    "blocks" : 0,
    "field_goals_attempted" : 20,
    "field_goals_made" : 4,
    "three_point_field_goals_attempted" : 5,
    "three_point_field_goals_made" : 0,
    "free_throws_attempted" : 13,
    "free_throws_made" : 11,
    "defensive_rebounds" : 4,
    "offensive_rebounds" : 0,
    "personal_fouls" : 3,
    "team_abbreviation" : "OKC",
    "is_starter" : true,
    "field_goal_percentage" : 0.2,
    "three_point_percentage" : 0.0,
    "free_throw_percentage" : 0.846
  }, {
    "last_name" : "Ibaka",
    "first_name" : "Serge",
    "display_name" : "Serge Ibaka",
    "position" : "PF",
    "minutes" : 26,
    "points" : 9,
    "assists" : 0,
    "turnovers" : 0,
    "steals" : 0,
    "blocks" : 2,
    "field_goals_attempted" : 9,
    "field_goals_made" : 3,
    "three_point_field_goals_attempted" : 0,
    "three_point_field_goals_made" : 0,
    "free_throws_attempted" : 4,
    "free_throws_made" : 3,
    "defensive_rebounds" : 0,
    "offensive_rebounds" : 4,
    "personal_fouls" : 3,
    "team_abbreviation" : "OKC",
    "is_starter" : true,
    "field_goal_percentage" : 0.333,
    "three_point_percentage" : 0.0,
    "free_throw_percentage" : 0.75
  }, {
    "last_name" : "Perkins",
    "first_name" : "Kendrick",
    "display_name" : "Kendrick Perkins",
    "position" : "C",
    "minutes" : 20,
    "points" : 2,
    "assists" : 0,
    "turnovers" : 1,
    "steals" : 1,
    "blocks" : 0,
    "field_goals_attempted" : 4,
    "field_goals_made" : 1,
    "three_point_field_goals_attempted" : 0,
    "three_point_field_goals_made" : 0,
    "free_throws_attempted" : 0,
    "free_throws_made" : 0,
    "defensive_rebounds" : 4,
    "offensive_rebounds" : 0,
    "personal_fouls" : 5,
    "team_abbreviation" : "OKC",
    "is_starter" : true,
    "field_goal_percentage" : 0.25,
    "three_point_percentage" : 0.0,
    "free_throw_percentage" : 0.0
  }, {
    "last_name" : "Sefolosha",
    "first_name" : "Thabo",
    "display_name" : "Thabo Sefolosha",
    "position" : "SF",
    "minutes" : 9,
    "points" : 0,
    "assists" : 0,
    "turnovers" : 0,
    "steals" : 0,
    "blocks" : 0,
    "field_goals_attempted" : 2,
    "field_goals_made" : 0,
    "three_point_field_goals_attempted" : 1,
    "three_point_field_goals_made" : 0,
    "free_throws_attempted" : 0,
    "free_throws_made" : 0,
    "defensive_rebounds" : 0,
    "offensive_rebounds" : 0,
    "personal_fouls" : 2,
    "team_abbreviation" : "OKC",
    "is_starter" : true,
    "field_goal_percentage" : 0.0,
    "three_point_percentage" : 0.0,
    "free_throw_percentage" : 0.0
  }, {
    "last_name" : "Harden",
    "first_name" : "James",
    "display_name" : "James Harden",
    "position" : "SG",
    "minutes" : 36,
    "points" : 19,
    "assists" : 5,
    "turnovers" : 3,
    "steals" : 2,
    "blocks" : 0,
    "field_goals_attempted" : 11,
    "field_goals_made" : 5,
    "three_point_field_goals_attempted" : 8,
    "three_point_field_goals_made" : 3,
    "free_throws_attempted" : 6,
    "free_throws_made" : 6,
    "defensive_rebounds" : 3,
    "offensive_rebounds" : 1,
    "personal_fouls" : 2,
    "team_abbreviation" : "OKC",
    "is_starter" : false,
    "field_goal_percentage" : 0.455,
    "three_point_percentage" : 0.375,
    "free_throw_percentage" : 1.0
  }, {
    "last_name" : "Fisher",
    "first_name" : "Derek",
    "display_name" : "Derek Fisher",
    "position" : "PG",
    "minutes" : 29,
    "points" : 11,
    "assists" : 3,
    "turnovers" : 0,
    "steals" : 0,
    "blocks" : 0,
    "field_goals_attempted" : 7,
    "field_goals_made" : 4,
    "three_point_field_goals_attempted" : 6,
    "three_point_field_goals_made" : 3,
    "free_throws_attempted" : 0,
    "free_throws_made" : 0,
    "defensive_rebounds" : 3,
    "offensive_rebounds" : 1,
    "personal_fouls" : 4,
    "team_abbreviation" : "OKC",
    "is_starter" : false,
    "field_goal_percentage" : 0.571,
    "three_point_percentage" : 0.5,
    "free_throw_percentage" : 0.0
  }, {
    "last_name" : "Collison",
    "first_name" : "Nick",
    "display_name" : "Nick Collison",
    "position" : "PF",
    "minutes" : 17,
    "points" : 2,
    "assists" : 1,
    "turnovers" : 0,
    "steals" : 0,
    "blocks" : 0,
    "field_goals_attempted" : 3,
    "field_goals_made" : 1,
    "three_point_field_goals_attempted" : 0,
    "three_point_field_goals_made" : 0,
    "free_throws_attempted" : 0,
    "free_throws_made" : 0,
    "defensive_rebounds" : 2,
    "offensive_rebounds" : 2,
    "personal_fouls" : 3,
    "team_abbreviation" : "OKC",
    "is_starter" : false,
    "field_goal_percentage" : 0.333,
    "three_point_percentage" : 0.0,
    "free_throw_percentage" : 0.0
  }, {
    "last_name" : "Cook",
    "first_name" : "Daequan",
    "display_name" : "Daequan Cook",
    "position" : "SG",
    "minutes" : 5,
    "points" : 2,
    "assists" : 1,
    "turnovers" : 0,
    "steals" : 0,
    "blocks" : 0,
    "field_goals_attempted" : 2,
    "field_goals_made" : 1,
    "three_point_field_goals_attempted" : 0,
    "three_point_field_goals_made" : 0,
    "free_throws_attempted" : 0,
    "free_throws_made" : 0,
    "defensive_rebounds" : 0,
    "offensive_rebounds" : 0,
    "personal_fouls" : 1,
    "team_abbreviation" : "OKC",
    "is_starter" : false,
    "field_goal_percentage" : 0.5,
    "three_point_percentage" : 0.0,
    "free_throw_percentage" : 0.0
  }, {
    "last_name" : "Aldrich",
    "first_name" : "Cole",
    "display_name" : "Cole Aldrich",
    "position" : "C",
    "minutes" : 5,
    "points" : 2,
    "assists" : 0,
    "turnovers" : 0,
    "steals" : 0,
    "blocks" : 0,
    "field_goals_attempted" : 1,
    "field_goals_made" : 1,
    "three_point_field_goals_attempted" : 0,
    "three_point_field_goals_made" : 0,
    "free_throws_attempted" : 0,
    "free_throws_made" : 0,
    "defensive_rebounds" : 1,
    "offensive_rebounds" : 0,
    "personal_fouls" : 0,
    "team_abbreviation" : "OKC",
    "is_starter" : false,
    "field_goal_percentage" : 1.0,
    "three_point_percentage" : 0.0,
    "free_throw_percentage" : 0.0
  }, {
    "last_name" : "Hayward",
    "first_name" : "Lazar",
    "display_name" : "Lazar Hayward",
    "position" : "SF",
    "minutes" : 5,
    "points" : 2,
    "assists" : 0,
    "turnovers" : 0,
    "steals" : 0,
    "blocks" : 0,
    "field_goals_attempted" : 2,
    "field_goals_made" : 1,
    "three_point_field_goals_attempted" : 0,
    "three_point_field_goals_made" : 0,
    "free_throws_attempted" : 0,
    "free_throws_made" : 0,
    "defensive_rebounds" : 2,
    "offensive_rebounds" : 0,
    "personal_fouls" : 1,
    "team_abbreviation" : "OKC",
    "is_starter" : false,
    "field_goal_percentage" : 0.5,
    "three_point_percentage" : 0.0,
    "free_throw_percentage" : 0.0
  }, {
    "last_name" : "Ivey",
    "first_name" : "Royal",
    "display_name" : "Royal Ivey",
    "position" : "PG",
    "minutes" : 3,
    "points" : 6,
    "assists" : 0,
    "turnovers" : 0,
    "steals" : 0,
    "blocks" : 0,
    "field_goals_attempted" : 2,
    "field_goals_made" : 2,
    "three_point_field_goals_attempted" : 2,
    "three_point_field_goals_made" : 2,
    "free_throws_attempted" : 0,
    "free_throws_made" : 0,
    "defensive_rebounds" : 0,
    "offensive_rebounds" : 0,
    "personal_fouls" : 0,
    "team_abbreviation" : "OKC",
    "is_starter" : false,
    "field_goal_percentage" : 1.0,
    "three_point_percentage" : 1.0,
    "free_throw_percentage" : 0.0
  } ],
  "home_stats" : [ {
    "last_name" : "James",
    "first_name" : "LeBron",
    "display_name" : "LeBron James",
    "position" : "SF",
    "minutes" : 44,
    "points" : 26,
    "assists" : 13,
    "turnovers" : 6,
    "steals" : 1,
    "blocks" : 2,
    "field_goals_attempted" : 19,
    "field_goals_made" : 9,
    "three_point_field_goals_attempted" : 3,
    "three_point_field_goals_made" : 0,
    "free_throws_attempted" : 9,
    "free_throws_made" : 8,
    "defensive_rebounds" : 7,
    "offensive_rebounds" : 4,
    "personal_fouls" : 2,
    "team_abbreviation" : "MIA",
    "is_starter" : true,
    "field_goal_percentage" : 0.474,
    "three_point_percentage" : 0.0,
    "free_throw_percentage" : 0.889
  }, {
    "last_name" : "Wade",
    "first_name" : "Dwyane",
    "display_name" : "Dwyane Wade",
    "position" : "SG",
    "minutes" : 35,
    "points" : 20,
    "assists" : 3,
    "turnovers" : 1,
    "steals" : 2,
    "blocks" : 3,
    "field_goals_attempted" : 12,
    "field_goals_made" : 7,
    "three_point_field_goals_attempted" : 0,
    "three_point_field_goals_made" : 0,
    "free_throws_attempted" : 9,
    "free_throws_made" : 6,
    "defensive_rebounds" : 6,
    "offensive_rebounds" : 2,
    "personal_fouls" : 4,
    "team_abbreviation" : "MIA",
    "is_starter" : true,
    "field_goal_percentage" : 0.583,
    "three_point_percentage" : 0.0,
    "free_throw_percentage" : 0.667
  }, {
    "last_name" : "Bosh",
    "first_name" : "Chris",
    "display_name" : "Chris Bosh",
    "position" : "PF",
    "minutes" : 34,
    "points" : 24,
    "assists" : 0,
    "turnovers" : 0,
    "steals" : 1,
    "blocks" : 2,
    "field_goals_attempted" : 14,
    "field_goals_made" : 9,
    "three_point_field_goals_attempted" : 1,
    "three_point_field_goals_made" : 1,
    "free_throws_attempted" : 5,
    "free_throws_made" : 5,
    "defensive_rebounds" : 7,
    "offensive_rebounds" : 0,
    "personal_fouls" : 1,
    "team_abbreviation" : "MIA",
    "is_starter" : true,
    "field_goal_percentage" : 0.643,
    "three_point_percentage" : 1.0,
    "free_throw_percentage" : 1.0
  }, {
    "last_name" : "Chalmers",
    "first_name" : "Mario",
    "display_name" : "Mario Chalmers",
    "position" : "PG",
    "minutes" : 34,
    "points" : 10,
    "assists" : 7,
    "turnovers" : 4,
    "steals" : 2,
    "blocks" : 0,
    "field_goals_attempted" : 6,
    "field_goals_made" : 3,
    "three_point_field_goals_attempted" : 4,
    "three_point_field_goals_made" : 2,
    "free_throws_attempted" : 2,
    "free_throws_made" : 2,
    "defensive_rebounds" : 1,
    "offensive_rebounds" : 1,
    "personal_fouls" : 3,
    "team_abbreviation" : "MIA",
    "is_starter" : true,
    "field_goal_percentage" : 0.5,
    "three_point_percentage" : 0.5,
    "free_throw_percentage" : 1.0
  }, {
    "last_name" : "Battier",
    "first_name" : "Shane",
    "display_name" : "Shane Battier",
    "position" : "SF",
    "minutes" : 29,
    "points" : 11,
    "assists" : 1,
    "turnovers" : 1,
    "steals" : 1,
    "blocks" : 0,
    "field_goals_attempted" : 8,
    "field_goals_made" : 4,
    "three_point_field_goals_attempted" : 7,
    "three_point_field_goals_made" : 3,
    "free_throws_attempted" : 0,
    "free_throws_made" : 0,
    "defensive_rebounds" : 4,
    "offensive_rebounds" : 0,
    "personal_fouls" : 4,
    "team_abbreviation" : "MIA",
    "is_starter" : true,
    "field_goal_percentage" : 0.5,
    "three_point_percentage" : 0.429,
    "free_throw_percentage" : 0.0
  }, {
    "last_name" : "Miller",
    "first_name" : "Mike",
    "display_name" : "Mike Miller",
    "position" : "SF",
    "minutes" : 23,
    "points" : 23,
    "assists" : 0,
    "turnovers" : 0,
    "steals" : 1,
    "blocks" : 0,
    "field_goals_attempted" : 11,
    "field_goals_made" : 7,
    "three_point_field_goals_attempted" : 8,
    "three_point_field_goals_made" : 7,
    "free_throws_attempted" : 2,
    "free_throws_made" : 2,
    "defensive_rebounds" : 5,
    "offensive_rebounds" : 0,
    "personal_fouls" : 4,
    "team_abbreviation" : "MIA",
    "is_starter" : false,
    "field_goal_percentage" : 0.636,
    "three_point_percentage" : 0.875,
    "free_throw_percentage" : 1.0
  }, {
    "last_name" : "Cole",
    "first_name" : "Norris",
    "display_name" : "Norris Cole",
    "position" : "PG",
    "minutes" : 17,
    "points" : 3,
    "assists" : 0,
    "turnovers" : 0,
    "steals" : 0,
    "blocks" : 0,
    "field_goals_attempted" : 4,
    "field_goals_made" : 1,
    "three_point_field_goals_attempted" : 2,
    "three_point_field_goals_made" : 1,
    "free_throws_attempted" : 0,
    "free_throws_made" : 0,
    "defensive_rebounds" : 1,
    "offensive_rebounds" : 0,
    "personal_fouls" : 2,
    "team_abbreviation" : "MIA",
    "is_starter" : false,
    "field_goal_percentage" : 0.25,
    "three_point_percentage" : 0.5,
    "free_throw_percentage" : 0.0
  }, {
    "last_name" : "Haslem",
    "first_name" : "Udonis",
    "display_name" : "Udonis Haslem",
    "position" : "PF",
    "minutes" : 11,
    "points" : 1,
    "assists" : 1,
    "turnovers" : 0,
    "steals" : 0,
    "blocks" : 0,
    "field_goals_attempted" : 1,
    "field_goals_made" : 0,
    "three_point_field_goals_attempted" : 0,
    "three_point_field_goals_made" : 0,
    "free_throws_attempted" : 2,
    "free_throws_made" : 1,
    "defensive_rebounds" : 0,
    "offensive_rebounds" : 1,
    "personal_fouls" : 1,
    "team_abbreviation" : "MIA",
    "is_starter" : false,
    "field_goal_percentage" : 0.0,
    "three_point_percentage" : 0.0,
    "free_throw_percentage" : 0.5
  }, {
    "last_name" : "Jones",
    "first_name" : "James",
    "display_name" : "James Jones",
    "position" : "SF",
    "minutes" : 5,
    "points" : 0,
    "assists" : 0,
    "turnovers" : 1,
    "steals" : 0,
    "blocks" : 0,
    "field_goals_attempted" : 1,
    "field_goals_made" : 0,
    "three_point_field_goals_attempted" : 1,
    "three_point_field_goals_made" : 0,
    "free_throws_attempted" : 0,
    "free_throws_made" : 0,
    "defensive_rebounds" : 0,
    "offensive_rebounds" : 0,
    "personal_fouls" : 0,
    "team_abbreviation" : "MIA",
    "is_starter" : false,
    "field_goal_percentage" : 0.0,
    "three_point_percentage" : 0.0,
    "free_throw_percentage" : 0.0
  }, {
    "last_name" : "Howard",
    "first_name" : "Juwan",
    "display_name" : "Juwan Howard",
    "position" : "PF",
    "minutes" : 3,
    "points" : 0,
    "assists" : 0,
    "turnovers" : 0,
    "steals" : 0,
    "blocks" : 0,
    "field_goals_attempted" : 1,
    "field_goals_made" : 0,
    "three_point_field_goals_attempted" : 0,
    "three_point_field_goals_made" : 0,
    "free_throws_attempted" : 0,
    "free_throws_made" : 0,
    "defensive_rebounds" : 0,
    "offensive_rebounds" : 0,
    "personal_fouls" : 0,
    "team_abbreviation" : "MIA",
    "is_starter" : false,
    "field_goal_percentage" : 0.0,
    "three_point_percentage" : 0.0,
    "free_throw_percentage" : 0.0
  }, {
    "last_name" : "Turiaf",
    "first_name" : "Ronny",
    "display_name" : "Ronny Turiaf",
    "position" : "C",
    "minutes" : 3,
    "points" : 0,
    "assists" : 0,
    "turnovers" : 0,
    "steals" : 0,
    "blocks" : 0,
    "field_goals_attempted" : 0,
    "field_goals_made" : 0,
    "three_point_field_goals_attempted" : 0,
    "three_point_field_goals_made" : 0,
    "free_throws_attempted" : 0,
    "free_throws_made" : 0,
    "defensive_rebounds" : 1,
    "offensive_rebounds" : 0,
    "personal_fouls" : 0,
    "team_abbreviation" : "MIA",
    "is_starter" : false,
    "field_goal_percentage" : 0.0,
    "three_point_percentage" : 0.0,
    "free_throw_percentage" : 0.0
  }, {
    "last_name" : "Harris",
    "first_name" : "Terrel",
    "display_name" : "Terrel Harris",
    "position" : "SG",
    "minutes" : 3,
    "points" : 3,
    "assists" : 0,
    "turnovers" : 0,
    "steals" : 0,
    "blocks" : 0,
    "field_goals_attempted" : 0,
    "field_goals_made" : 0,
    "three_point_field_goals_attempted" : 0,
    "three_point_field_goals_made" : 0,
    "free_throws_attempted" : 4,
    "free_throws_made" : 3,
    "defensive_rebounds" : 1,
    "offensive_rebounds" : 0,
    "personal_fouls" : 0,
    "team_abbreviation" : "MIA",
    "is_starter" : false,
    "field_goal_percentage" : 0.0,
    "three_point_percentage" : 0.0,
    "free_throw_percentage" : 0.75
  } ],
  "officials" : [ {
    "position" : null,
    "first_name" : "Derrick",
    "last_name" : "Stafford"
  }, {
    "position" : null,
    "first_name" : "Dan",
    "last_name" : "Crawford"
  }, {
    "position" : null,
    "first_name" : "Monty",
    "last_name" : "McCutchen"
  } ],
  "event_information" : {
    "temperature" : 0,
    "site" : {
      "capacity" : 19600,
      "surface" : "Hardwood",
      "name" : "AmericanAirlines Arena",
      "state" : "Florida",
      "city" : "Miami"
    },
    "attendance" : 20003,
    "duration" : "2:40",
    "season_type" : "post",
    "start_date_time" : "2012-06-21T18:00:00-07:00"
  },
  "away_totals" : {
    "minutes" : 241,
    "points" : 106,
    "assists" : 19,
    "turnovers" : 13,
    "steals" : 7,
    "blocks" : 3,
    "field_goals_attempted" : 87,
    "field_goals_made" : 36,
    "three_point_field_goals_attempted" : 28,
    "three_point_field_goals_made" : 11,
    "free_throws_attempted" : 26,
    "free_throws_made" : 23,
    "defensive_rebounds" : 28,
    "offensive_rebounds" : 10,
    "personal_fouls" : 29,
    "field_goal_percentage" : 0.414,
    "three_point_percentage" : 0.393,
    "free_throw_percentage" : 0.885
  },
  "home_totals" : {
    "minutes" : 241,
    "points" : 121,
    "assists" : 25,
    "turnovers" : 13,
    "steals" : 8,
    "blocks" : 7,
    "field_goals_attempted" : 77,
    "field_goals_made" : 40,
    "three_point_field_goals_attempted" : 26,
    "three_point_field_goals_made" : 14,
    "free_throws_attempted" : 33,
    "free_throws_made" : 27,
    "defensive_rebounds" : 33,
    "offensive_rebounds" : 8,
    "personal_fouls" : 21,
    "field_goal_percentage" : 0.519,
    "three_point_percentage" : 0.538,
    "free_throw_percentage" : 0.818
  }
}