Basketball API Tech Docs

Basketball API Match Boxscore

Provides player based statistics during the match like free throw attempted/made, field goals attempted/made, 3 points attempted/made and other statistics.

Basketball Match Boxscore Request URL

GET

References / Dependencies

Tournament ID The id of the tournament. You can find list of the tournament from Tournament List endpoint

Stage / Round Structure Stage / Round structures change tournament by tournament. You can find the structures with Tournament Id from Tournament Info endpoint

Matches from Fixture Match Ids can be retrieved from The fixture of the tournament. You can find all matches of the tournament from Tournament Fixture endpoint

Matches from Match List Match Ids can be retrieved from The Daily Match List. You can find all matches in 7-days period from Match List endpoint

Call Rate / Interval

Recommended API Call Interval at live: 6 Request / Minute Recommended API Call Interval at 1 hour after game end: 2 Request / Minute Recommended API Call Interval at more than 1 hour after game end: 6 Request / Hour

Request Headers

Data	Type	O / R	Example	Description
languageId	INT	R	{languageId}	The id of the language that you select.
Ocp-Apim-Subscription-Key	STR	R	{yourOcp-Apim-Subscription-Key}	Your account key.
Accept	STR	O	application/xml	Selection of data presentation type as XML/JSON.

^*O= Optional, R= Required

Request Parameters

Data	Type	O / R	Example	Description
matchId	INT	R	{matchId}	The id of the match

Response Output

{ "homeTeam": { "boxscore": [ { "player": { "country": { "name": "U.S.A", "shortName": "USA", "id": 18 }, "knownName": "Khyri Thomas", "shirtNumber": "13", "id": 20960 }, "statistics": { "totalPoints": 0, "onBench": true, "dnp": true } }, { "player": { "country": { "name": "U.S.A", "shortName": "USA", "id": 18 }, "knownName": "Langston Galloway", "shirtNumber": "9", "id": 6750 }, "statistics": { "playingTime": "21:06", "totalPoints": 2, "successfulFreeThrows": 0, "freeThrowAttempts": 0, "freeThrowSuccessRate": 0, "successfulFieldGoals": 1, "fieldGoalAttempts": 2, "fieldGoalSuccessRate": 0.5, "successfulThreePointShots": 0, "threePointShotAttempts": 5, "threePointSuccessRate": 0, "defensiveRebounds": 3, "offensiveRebounds": 0, "totalRebounds": 3, "assists": 4, "turnovers": 0, "steals": 0, "blocks": 0, "personalFouls": 2, "onBench": true } }, { "player": { "country": { "name": "U.S.A", "shortName": "USA", "id": 18 }, "knownName": "Glenn Robinson III", "shirtNumber": "22", "id": 6860 }, "statistics": { "playingTime": "13:25", "totalPoints": 10, "successfulFreeThrows": 1, "freeThrowAttempts": 2, "freeThrowSuccessRate": 0.5, "successfulFieldGoals": 3, "fieldGoalAttempts": 3, "fieldGoalSuccessRate": 1, "successfulThreePointShots": 1, "threePointShotAttempts": 2, "threePointSuccessRate": 0.5, "defensiveRebounds": 2, "offensiveRebounds": 0, "totalRebounds": 2, "assists": 0, "turnovers": 1, "steals": 0, "blocks": 0, "personalFouls": 2, "isStarting": true } }, { "player": { "country": { "name": "U.S.A", "shortName": "USA", "id": 18 }, "knownName": "Reggie Jackson", "shirtNumber": "1", "id": 1616 }, "statistics": { "playingTime": "33:25", "totalPoints": 22, "successfulFreeThrows": 12, "freeThrowAttempts": 14, "freeThrowSuccessRate": 0.857, "successfulFieldGoals": 5, "fieldGoalAttempts": 9, "fieldGoalSuccessRate": 0.556, "successfulThreePointShots": 0, "threePointShotAttempts": 3, "threePointSuccessRate": 0, "defensiveRebounds": 4, "offensiveRebounds": 0, "totalRebounds": 4, "assists": 6, "turnovers": 1, "steals": 1, "blocks": 0, "personalFouls": 3, "isStarting": true } }, { "player": { "country": { "name": "Spain", "shortName": "ESP", "id": 3 }, "knownName": "Jose Calderon", "shirtNumber": "81", "id": 1859 }, "statistics": { "totalPoints": 0, "onBench": true, "dnp": true } }, { "player": { "country": { "name": "Georgia", "shortName": "GEO", "id": 49 }, "knownName": "Zaza Pachulia", "shirtNumber": "27", "id": 1539 }, "statistics": { "playingTime": "04:18", "totalPoints": 0, "successfulFreeThrows": 0, "freeThrowAttempts": 0, "freeThrowSuccessRate": 0, "successfulFieldGoals": 0, "fieldGoalAttempts": 2, "fieldGoalSuccessRate": 0, "successfulThreePointShots": 0, "threePointShotAttempts": 0, "threePointSuccessRate": 0, "defensiveRebounds": 1, "offensiveRebounds": 0, "totalRebounds": 1, "assists": 0, "turnovers": 0, "steals": 0, "blocks": 0, "personalFouls": 0, "onBench": true } }, { "player": { "country": { "name": "U.S.A", "shortName": "USA", "id": 18 }, "knownName": "Bruce Brown", "shirtNumber": "6", "id": 20959 }, "statistics": { "playingTime": "25:14", "totalPoints": 7, "successfulFreeThrows": 3, "freeThrowAttempts": 4, "freeThrowSuccessRate": 0.75, "successfulFieldGoals": 2, "fieldGoalAttempts": 3, "fieldGoalSuccessRate": 0.667, "successfulThreePointShots": 0, "threePointShotAttempts": 0, "threePointSuccessRate": 0, "defensiveRebounds": 1, "offensiveRebounds": 1, "totalRebounds": 2, "assists": 1, "turnovers": 0, "steals": 3, "blocks": 0, "personalFouls": 2, "onBench": true } }, { "player": { "country": { "name": "U.S.A", "shortName": "USA", "id": 18 }, "knownName": "Stanley Johnson", "shirtNumber": "7", "id": 8290 }, "statistics": { "playingTime": "15:26", "totalPoints": 7, "successfulFreeThrows": 0, "freeThrowAttempts": 0, "freeThrowSuccessRate": 0, "successfulFieldGoals": 2, "fieldGoalAttempts": 5, "fieldGoalSuccessRate": 0.4, "successfulThreePointShots": 1, "threePointShotAttempts": 3, "threePointSuccessRate": 0.333, "defensiveRebounds": 1, "offensiveRebounds": 0, "totalRebounds": 1, "assists": 0, "turnovers": 3, "steals": 2, "blocks": 0, "personalFouls": 0, "onBench": true } }, { "player": { "country": { "name": "U.S.A", "shortName": "USA", "id": 18 }, "knownName": "Reggie Bullock", "shirtNumber": "25", "id": 3507 }, "statistics": { "playingTime": "39:23", "totalPoints": 8, "successfulFreeThrows": 0, "freeThrowAttempts": 0, "freeThrowSuccessRate": 0, "successfulFieldGoals": 1, "fieldGoalAttempts": 1, "fieldGoalSuccessRate": 1, "successfulThreePointShots": 2, "threePointShotAttempts": 4, "threePointSuccessRate": 0.5, "defensiveRebounds": 3, "offensiveRebounds": 2, "totalRebounds": 5, "assists": 2, "turnovers": 1, "steals": 2, "blocks": 0, "personalFouls": 2, "isStarting": true } }, { "player": { "country": { "name": "U.S.A", "shortName": "USA", "id": 18 }, "knownName": "Ishmael Smith", "shirtNumber": "14", "id": 1521 }, "statistics": { "playingTime": "20:33", "totalPoints": 9, "successfulFreeThrows": 0, "freeThrowAttempts": 0, "freeThrowSuccessRate": 0, "successfulFieldGoals": 3, "fieldGoalAttempts": 7, "fieldGoalSuccessRate": 0.429, "successfulThreePointShots": 1, "threePointShotAttempts": 3, "threePointSuccessRate": 0.333, "defensiveRebounds": 2, "offensiveRebounds": 0, "totalRebounds": 2, "assists": 0, "turnovers": 2, "steals": 0, "blocks": 0, "personalFouls": 1, "onBench": true } }, { "player": { "country": { "name": "U.S.A", "shortName": "USA", "id": 18 }, "knownName": "Blake Griffin", "shirtNumber": "23", "id": 1694 }, "statistics": { "playingTime": "43:26", "totalPoints": 28, "successfulFreeThrows": 8, "freeThrowAttempts": 12, "freeThrowSuccessRate": 0.667, "successfulFieldGoals": 7, "fieldGoalAttempts": 12, "fieldGoalSuccessRate": 0.583, "successfulThreePointShots": 2, "threePointShotAttempts": 6, "threePointSuccessRate": 0.333, "defensiveRebounds": 7, "offensiveRebounds": 2, "totalRebounds": 9, "assists": 4, "turnovers": 4, "steals": 0, "blocks": 0, "personalFouls": 3, "isStarting": true } }, { "player": { "country": { "name": "U.S.A", "shortName": "USA", "id": 18 }, "knownName": "Jon Leuer", "shirtNumber": "30", "id": 1840 }, "statistics": { "playingTime": "04:27", "totalPoints": 0, "successfulFreeThrows": 0, "freeThrowAttempts": 0, "freeThrowSuccessRate": 0, "successfulFieldGoals": 0, "fieldGoalAttempts": 0, "fieldGoalSuccessRate": 0, "successfulThreePointShots": 0, "threePointShotAttempts": 0, "threePointSuccessRate": 0, "defensiveRebounds": 0, "offensiveRebounds": 0, "totalRebounds": 0, "assists": 0, "turnovers": 0, "steals": 0, "blocks": 0, "personalFouls": 2, "onBench": true } }, { "player": { "country": { "name": "U.S.A", "shortName": "USA", "id": 18 }, "knownName": "Andre Drummond", "shirtNumber": "0", "id": 1587 }, "statistics": { "playingTime": "44:15", "totalPoints": 23, "successfulFreeThrows": 5, "freeThrowAttempts": 8, "freeThrowSuccessRate": 0.625, "successfulFieldGoals": 9, "fieldGoalAttempts": 17, "fieldGoalSuccessRate": 0.529, "successfulThreePointShots": 0, "threePointShotAttempts": 1, "threePointSuccessRate": 0, "defensiveRebounds": 11, "offensiveRebounds": 9, "totalRebounds": 20, "assists": 1, "turnovers": 1, "steals": 3, "blocks": 5, "personalFouls": 1, "isStarting": true } } ], "name": "Detroit Pistons", "shortName": "DET", "mediumName": "Pistons", "id": 108 }, "awayTeam": { "boxscore": [ { "player": { "country": { "name": "Germany", "shortName": "GER", "id": 8 }, "knownName": "Isaiah Hartenstein", "shirtNumber": "55", "id": 6392 }, "statistics": { "playingTime": "06:57", "totalPoints": 2, "successfulFreeThrows": 0, "freeThrowAttempts": 0, "freeThrowSuccessRate": 0, "successfulFieldGoals": 1, "fieldGoalAttempts": 1, "fieldGoalSuccessRate": 1, "successfulThreePointShots": 0, "threePointShotAttempts": 1, "threePointSuccessRate": 0, "defensiveRebounds": 1, "offensiveRebounds": 0, "totalRebounds": 1, "assists": 0, "turnovers": 0, "steals": 0, "blocks": 1, "personalFouls": 3, "onBench": true } }, { "player": { "country": { "name": "Switzerland", "shortName": "SWI", "id": 36 }, "knownName": "Clint Capela", "shirtNumber": "15", "id": 822 }, "statistics": { "playingTime": "43:28", "totalPoints": 29, "successfulFreeThrows": 1, "freeThrowAttempts": 1, "freeThrowSuccessRate": 1, "successfulFieldGoals": 14, "fieldGoalAttempts": 21, "fieldGoalSuccessRate": 0.667, "successfulThreePointShots": 0, "threePointShotAttempts": 0, "threePointSuccessRate": 0, "defensiveRebounds": 9, "offensiveRebounds": 12, "totalRebounds": 21, "assists": 1, "turnovers": 3, "steals": 2, "blocks": 3, "personalFouls": 2, "isStarting": true } }, { "player": { "country": { "name": "U.S.A", "shortName": "USA", "id": 18 }, "knownName": "P.J. Tucker", "shirtNumber": "17", "id": 1795 }, "statistics": { "playingTime": "44:04", "totalPoints": 11, "successfulFreeThrows": 0, "freeThrowAttempts": 0, "freeThrowSuccessRate": 0, "successfulFieldGoals": 1, "fieldGoalAttempts": 4, "fieldGoalSuccessRate": 0.25, "successfulThreePointShots": 3, "threePointShotAttempts": 6, "threePointSuccessRate": 0.5, "defensiveRebounds": 7, "offensiveRebounds": 1, "totalRebounds": 8, "assists": 2, "turnovers": 1, "steals": 1, "blocks": 0, "personalFouls": 4, "isStarting": true } }, { "player": { "country": { "name": "U.S.A", "shortName": "USA", "id": 18 }, "knownName": "Gary Clark", "shirtNumber": "6", "id": 22047 }, "statistics": { "playingTime": "14:25", "totalPoints": 0, "successfulFreeThrows": 0, "freeThrowAttempts": 0, "freeThrowSuccessRate": 0, "successfulFieldGoals": 0, "fieldGoalAttempts": 0, "fieldGoalSuccessRate": 0, "successfulThreePointShots": 0, "threePointShotAttempts": 2, "threePointSuccessRate": 0, "defensiveRebounds": 2, "offensiveRebounds": 0, "totalRebounds": 2, "assists": 0, "turnovers": 0, "steals": 0, "blocks": 2, "personalFouls": 1, "onBench": true } }, { "player": { "country": { "name": "U.S.A", "shortName": "USA", "id": 18 }, "knownName": "Eric Gordon", "shirtNumber": "10", "id": 1870 }, "statistics": { "playingTime": "34:24", "totalPoints": 11, "successfulFreeThrows": 2, "freeThrowAttempts": 2, "freeThrowSuccessRate": 1, "successfulFieldGoals": 3, "fieldGoalAttempts": 8, "fieldGoalSuccessRate": 0.375, "successfulThreePointShots": 1, "threePointShotAttempts": 6, "threePointSuccessRate": 0.167, "defensiveRebounds": 2, "offensiveRebounds": 0, "totalRebounds": 2, "assists": 2, "turnovers": 0, "steals": 1, "blocks": 0, "personalFouls": 4, "onBench": true } }, { "player": { "country": { "name": "U.S.A", "shortName": "USA", "id": 18 }, "knownName": "Chris Paul", "shirtNumber": "3", "id": 1690 }, "statistics": { "playingTime": "36:54", "totalPoints": 20, "successfulFreeThrows": 4, "freeThrowAttempts": 4, "freeThrowSuccessRate": 1, "successfulFieldGoals": 5, "fieldGoalAttempts": 10, "fieldGoalSuccessRate": 0.5, "successfulThreePointShots": 2, "threePointShotAttempts": 6, "threePointSuccessRate": 0.333, "defensiveRebounds": 3, "offensiveRebounds": 1, "totalRebounds": 4, "assists": 9, "turnovers": 2, "steals": 0, "blocks": 0, "personalFouls": 5, "isStarting": true } }, { "player": { "country": { "name": "U.S.A", "shortName": "USA", "id": 18 }, "knownName": "James Ennis", "shirtNumber": "8", "id": 6797 }, "statistics": { "playingTime": "29:08", "totalPoints": 5, "successfulFreeThrows": 0, "freeThrowAttempts": 0, "freeThrowSuccessRate": 0, "successfulFieldGoals": 1, "fieldGoalAttempts": 2, "fieldGoalSuccessRate": 0.5, "successfulThreePointShots": 1, "threePointShotAttempts": 2, "threePointSuccessRate": 0.5, "defensiveRebounds": 1, "offensiveRebounds": 2, "totalRebounds": 3, "assists": 0, "turnovers": 1, "steals": 2, "blocks": 0, "personalFouls": 2, "isStarting": true } }, { "player": { "country": { "name": "U.S.A", "shortName": "USA", "id": 18 }, "knownName": "Marquese Chriss", "shirtNumber": "0", "id": 12403 }, "statistics": { "totalPoints": 0, "onBench": true, "dnp": true } }, { "player": { "country": { "name": "U.S.A", "shortName": "USA", "id": 18 }, "knownName": "Gerald Green", "shirtNumber": "14", "id": 1793 }, "statistics": { "playingTime": "14:45", "totalPoints": 0, "successfulFreeThrows": 0, "freeThrowAttempts": 0, "freeThrowSuccessRate": 0, "successfulFieldGoals": 0, "fieldGoalAttempts": 0, "fieldGoalSuccessRate": 0, "successfulThreePointShots": 0, "threePointShotAttempts": 2, "threePointSuccessRate": 0, "defensiveRebounds": 1, "offensiveRebounds": 0, "totalRebounds": 1, "assists": 0, "turnovers": 0, "steals": 0, "blocks": 0, "personalFouls": 0, "onBench": true } }, { "player": { "country": { "name": "U.S.A", "shortName": "USA", "id": 18 }, "knownName": "James Harden", "shirtNumber": "13", "id": 1848 }, "statistics": { "playingTime": "40:53", "totalPoints": 33, "successfulFreeThrows": 12, "freeThrowAttempts": 14, "freeThrowSuccessRate": 0.857, "successfulFieldGoals": 6, "fieldGoalAttempts": 16, "fieldGoalSuccessRate": 0.375, "successfulThreePointShots": 3, "threePointShotAttempts": 11, "threePointSuccessRate": 0.273, "defensiveRebounds": 1, "offensiveRebounds": 1, "totalRebounds": 2, "assists": 8, "turnovers": 7, "steals": 0, "blocks": 1, "personalFouls": 5, "isStarting": true } }, { "player": { "country": { "name": "U.S.A", "shortName": "USA", "id": 18 }, "knownName": "Michael Carter-Williams", "shirtNumber": "1", "id": 3440 }, "statistics": { "totalPoints": 0, "onBench": true, "dnp": true } } ], "name": "Houston Rockets", "shortName": "HOU ", "mediumName": "Rockets", "id": 110 }, "tournament": { "name": "NBA", "shortName": "NBA", "id": 9 }, "stage": { "name": "Regular Season", "shortName": "NS", "id": 16803 }, "round": { "name": "Round 6", "shortName": "W6", "id": 6 }, "date": "24/11/2018 00:00:00", "id": 287131 }

Response Output Definitions

match

Data

Type

Example

Description

date

DATE/STR

24/11/2018 00:00:00

The starting date of the match, includes also time

INT

287131

The id of the match

homeTeam/awayTeam

Data

Type

Example

Description

name

STR

Memphis Grizzlies

The name of the home/away team

shortName

STR

MEM

The short name of the home/away team

mediumName

STR

Grizzlies

The medium name of the home/away team

INT

114

The id of the home/away team

player

Data

Type

Example

Description

knownName

STR

Russell Westbrook

The full name of the player

shirtName

STR

The short name of the player

INT

1620

The id of the player

country

Data	Type	Example	Description
name	STR	U.S.A	The name of the country
shortName	STR	USA	The short name of the country
id	INT	18	The id of the country

statistics

Data	Type	Example	Description
playingTime	STR	35:31	Player’s total playing time in the match
totalPoints	INT	22	Player’s total points count
successfulFreeThrows	INT	4	Player’s successful free throw count
freeThrowAttempts	INT	6	Player’s free throw attempt count
freeThrowSuccessRate	fLT	0.667	Player’s free throw success rate
successfulFieldGoals	INT	3	Player’s successful field goal count
fieldGoalAttempts	INT	7	Player’s field goal attempt count
fieldGoalSuccessRate	FLT	0.429	Player’s field goal success rate
successfulThreePointShots	INT	4	Player’s successful three points count
threePointShotAttempts	INT	13	Player’s three points attempt count
threePointSuccessRate	FLT	0.308	Player’s three points success rate
defensiveRebounds	INT	4	Player’s defensive rebounds count
offensiveRebounds	INT	2	Player’s offensive rebounds count
totalRebounds	INT	6	Player’s total rebounds count
assists	INT	5	Player’s assist count
turnovers	INT	4	Player’s turnover count
steals	INT	3	Player’s steal count
blocks	INT	1	Player’s block count
personalFouls	INT	3	Player’s personal foul count
isStarting	BLN	true	Player is in starting5 or not
onBench	BLN	true	Player is on the bench or not
dnp	BLN	true	Means player is on the bench but Did Not Play. This parameter is set after the match is finished.

tournament

Data	Type	Example	Description
name	STR	English Premier League	The name of the tournament for the match
shortName	STR	EPL	The short name of the tournament for the match
id	INT	2	The id of the tournament for the match

stage

Data	Type	Example	Description
name	STR	2018/2019 Season	The name of the stage for the match
shortName	STR	18/19	The short name of the stage for the match
id	INT	37295	The id of the stage for the match

round

Data	Type	Example	Description
name	STR	Round 24	The name of the round for the match
shortName	STR	W24	The short name of the round for the match
id	INT	24	The id of the round for the match

Basketball API Tech Docs

Tech Docs Index

Documentation

Widgets

Lookups

Global API

Soccer API

Basketball API

Football API

Baseball API

Ice Hockey API

Volleyball API

Handball API

Table Tennis API

Tennis API

Basketball API Match Boxscore

Basketball Match Boxscore Request URL

References / Dependencies

Call Rate / Interval

Request Headers

Request Parameters

Response Output

Response Output Definitions

match

homeTeam/awayTeam

player

country

statistics

tournament

stage

round