Box Scores

Use this endpoint to retrieve box scores for NBA games.

import { Time4BoostAPI } from "@time4boost/sdk";

const api = new Time4BoostAPI({ apiKey: "YOUR_API_KEY" });
const boxScores = await api.nba.getBoxScores({ 
  game_ids: [857289] 
});

The above command returns JSON structured like this:

{
  "data": [
    {
      "id": 857289,
      "date": "2023-12-25T00:00:00.000Z",
      "home_team": {
        "id": 20,
        "abbreviation": "NYK",
        "city": "New York",
        "conference": "East",
        "division": "Atlantic",
        "full_name": "New York Knicks",
        "name": "Knicks"
      },
      "home_team_score": 119,
      "period": 4,
      "postseason": false,
      "season": 2023,
      "status": "Final",
      "time": " ",
      "visitor_team": {
        "id": 16,
        "abbreviation": "MIL",
        "city": "Milwaukee",
        "conference": "East",
        "division": "Central",
        "full_name": "Milwaukee Bucks",
        "name": "Bucks"
      },
      "visitor_team_score": 122,
      "home_team_stats": [
        {
          "player": {
            "id": 666786,
            "first_name": "Jalen",
            "last_name": "Brunson",
            "position": "G",
            "team_id": 20
          },
          "min": "39:47",
          "fgm": 15,
          "fga": 28,
          "fg3m": 6,
          "fg3a": 11,
          "ftm": 2,
          "fta": 2,
          "oreb": 0,
          "dreb": 4,
          "reb": 4,
          "ast": 6,
          "stl": 1,
          "blk": 0,
          "turnover": 2,
          "pf": 3,
          "pts": 38,
          "fg_pct": 0.536,
          "fg3_pct": 0.545,
          "ft_pct": 1
        },
        // ... more player stats
      ],
      "visitor_team_stats": [
        {
          "player": {
            "id": 246,
            "first_name": "Giannis",
            "last_name": "Antetokounmpo",
            "position": "F",
            "team_id": 16
          },
          "min": "36:47",
          "fgm": 9,
          "fga": 19,
          "fg3m": 2,
          "fg3a": 6,
          "ftm": 3,
          "fta": 4,
          "oreb": 1,
          "dreb": 5,
          "reb": 6,
          "ast": 6,
          "stl": 2,
          "blk": 0,
          "turnover": 3,
          "pf": 1,
          "pts": 23,
          "fg_pct": 0.474,
          "fg3_pct": 0.333,
          "ft_pct": 0.75
        },
        // ... more player stats
      ]
    }
  ]
}

GET https://api.time4boost.com/v1/box_scores