Basketball API Tech Docs

Search in tech docs

Basketball API Match List: All

Provides the daily match list in active season and includes scheduled, live and finished matches.

Basketball Match List: All Request URL

GET

References / Dependencies

There is no references/dependencies for Match List. Match List endpoints works with only date parameter.

Call Rate / Interval

Recommended API Call Interval: 20 Request / Minute Daily Max API Call: 28800 Request

± 7 days Match Period

Match List data can be retrieved for only ± 7 days.

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
date	DATE/STR	R	{dd/MM/yyyy}	Date of the match

Response Output

[ { "homeTeam": { "score": { "quarter1": 27, "quarter2": 26, "halfTime": 53, "quarter3": 23, "quarter4": 35, "regular": 111, "current": 111 }, "name": "Orlando Magic", "shortName": "ORL", "mediumName": "Magic", "id": 122 }, "awayTeam": { "score": { "quarter1": 30, "quarter2": 22, "halfTime": 52, "quarter3": 35, "quarter4": 19, "regular": 106, "current": 106 }, "name": "Philadelphia 76ers", "shortName": "PHI", "mediumName": "76ers", "id": 123 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "tournament": { "name": "NBA", "shortName": "NBA", "id": 9 }, "stage": { "name": "Regular Season", "shortName": "NS", "id": 16803 }, "round": { "name": "Round 5", "shortName": "W5", "id": 5 }, "date": "15/11/2018 00:00:00", "id": 287066 }, { "homeTeam": { "score": { "quarter1": 41, "quarter2": 32, "halfTime": 73, "quarter3": 23, "quarter4": 23, "regular": 119, "current": 119 }, "name": "Washington Wizards", "shortName": "WAS", "mediumName": "Wizards", "id": 130 }, "awayTeam": { "score": { "quarter1": 29, "quarter2": 23, "halfTime": 52, "quarter3": 22, "quarter4": 21, "regular": 95, "current": 95 }, "name": "Cleveland Cavaliers", "shortName": "CLE", "mediumName": "Cavaliers", "id": 105 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "tournament": { "name": "NBA", "shortName": "NBA", "id": 9 }, "stage": { "name": "Regular Season", "shortName": "NS", "id": 16803 }, "round": { "name": "Round 5", "shortName": "W5", "id": 5 }, "date": "15/11/2018 00:00:00", "id": 287067 } ]

sample 1 - NBA

Response Output Definitions

match

Data

Type

Example

Description

date

DATE/STR

28/02/2019 03:00:00

The kick-off date of the match, includes also time

INT

287784

The id of the match

homeTeam/awayTeam

Data

Type

Example

Description

name

STR

Sacramento Kings

The full name of the home/away team

shortName

STR

SAC

The short name of the home/away team

mediumName

STR

Kings)

The medium name of the home/away team

INT

126

The id of the home/away team

score

Data	Type	Example	Description
regular	INT	126	The regular score of the match for home/away team
halfTime	INT	62	The half-time score of the match for home/away team
current	INT	130	The current score of the match (live and post) for home/away team
quarter1	INT	33	The 1st quarter score of the match for home/away team
quarter2	INT	29	The 2nd quarter score of the match for home/away team
quarter3	INT	29	The 3rd quarter score of the match for home/away team
quarter4	INT	35	The 4th quarter score of the match for home/away team
overTime	INT	10	The overtime score of the match for home/away team

status

Data	Type	Example	Description
name	STR	Extra Time - 1st Half	The name of the status
shortName	STR	1ET	The short name of the status
id	INT	6	The id of the status

gameClock (can be null for unsupported tournaments)

Data	Type	Example	Description
minute	INT	1	The remaining minute of the match’s current quarter
second	INT	20	The remaining second of the match’s current quarter

tournament

Data	Type	Example	Description
name	STR	NBA	The name of the tournament
shortName	STR	NBA	The short name of the tournament
id	INT	9	The id of the tournament

stage

Data	Type	Example	Description
name	STR	Regular Season	The name of the stage
shortName	STR	NS	The short name of the stage
id	INT	16803	The id of the stage

round

Data	Type	Example	Description
name	STR	Round 20	The name of the round
shortName	STR	W20	The short name of the round
id	INT	20	The id of the round

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+