Basketball / Box scores

Get Box Scores

Retrieve the team and player box score for a game, updated while the game is in progress.

GET/v1/basketball/boxscores

Parameters

NameTypeRequiredDescription

x-api-keystringRequiredYour API key, sent as a header.

game_idintegerRequiredGame ID.

team_idintegerOptionalReturn only this team’s box score.

Response

dataobject<BoxScore>
Box score for the game.
game_idinteger
Unique game ID.
statusobject
short, period and game clock.
teamsarray<TeamBox>
Home team first, then away.
teamobject
id and name.
pointsinteger
Team total.
playersarray
Minutes, points, rebounds and assists per player.

Status codes

200Box score returned
400Invalid parameter
401Missing or invalid API key
429Rate limit reached

Try it out

1curl -G "https://api.gosportsapi.com/v1/basketball/boxscores" \
2  -H "x-api-key: YOUR_API_KEY" \
3  -d game_id=402118

200 OKapplication/json

1{
2  "data": {
3    "game_id": 402118,
4    "status": { "short": "LIVE", "period": 4, "clock": "04:21" },
5    "teams": [
6      {
7        "team": { "id": 145, "name": "Los Angeles Lakers" },
8        "points": 104,
9        "players": [
10          { "player": "Luka Dončić", "minutes": 34, "points": 31, "rebounds": 8, "assists": 9 }
11        ]
12      },
13      {
14        "team": { "id": 133, "name": "Boston Celtics" },
15        "points": 98,
16        "players": [
17          { "player": "Jayson Tatum", "minutes": 35, "points": 27, "rebounds": 9, "assists": 5 }
18        ]
19      }
20    ]
21  }
22}

API Information

Data freshness: ~30 seconds
Recommended polling: 60 seconds
Request cost: 1 request
Required plan: [Plan]+