Baseball API Tech Docs

Search in tech docs

Baseball API Match List: All

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

Baseball 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": { "name": "New York Mets", "shortName": "METS", "mediumName": "Mets", "id": 18 }, "awayTeam": { "name": "Miami Marlins", "shortName": "MIA", "mediumName": "M. Marlins", "id": 48 }, "status": { "name": "Postponed", "shortName": "PSP", "id": 21 }, "tournament": { "name": "Major League Baseball", "shortName": "MLB", "id": 3 }, "stage": { "name": "Regular Season", "shortName": "NS", "id": 254 }, "round": { "name": "Round 8", "shortName": "W8", "id": 8 }, "date": "12/05/2019 17:10:00", "id": 44666 }, { "homeTeam": { "score": { "inning1": 0, "inning2": 0, "inning3": 0, "inning4": 3, "inning5": 0, "inning6": 0, "inning7": 0, "inning8": 0, "inning9": 0, "current": 3, "regular": 3 }, "name": "Arizona Diamondbacks", "shortName": "ARI", "mediumName": "Diamondbacks", "id": 27 }, "awayTeam": { "score": { "inning1": 0, "inning2": 1, "inning3": 3, "inning4": 0, "inning5": 0, "inning6": 0, "inning7": 0, "inning8": 1, "inning9": 0, "current": 5, "regular": 5 }, "name": "Atlanta Braves", "shortName": "ATL", "mediumName": "Braves", "id": 16 }, "status": { "name": "Full Time", "shortName": "FT", "id": 5 }, "tournament": { "name": "Major League Baseball", "shortName": "MLB", "id": 3 }, "stage": { "name": "Regular Season", "shortName": "NS", "id": 254 }, "round": { "name": "Round 8", "shortName": "W8", "id": 8 }, "date": "12/05/2019 20:10:00", "id": 44676 }, { "homeTeam": { "name": "Chicago Cubs", "shortName": "CHI", "mediumName": "Cubs", "id": 21 }, "awayTeam": { "name": "Milwaukee Brewers", "shortName": "MIL", "mediumName": "Brewers", "id": 24 }, "status": { "name": "Scheduled", "shortName": "SCH", "id": 1 }, "tournament": { "name": "Major League Baseball", "shortName": "MLB", "id": 3 }, "stage": { "name": "Regular Season", "shortName": "NS", "id": 254 }, "round": { "name": "Round 9", "shortName": "W9", "id": 9 }, "date": "12/05/2019 23:05:00", "id": 44677 } ]

sample 1

Response Output Definitions

match

Data

Type

Example

Description

date

DATE/STR

12/05/2019 20:10:00

The starting date of the match, includes also time

INT

44676

The id of the match

homeTeam/awayTeam

Data

Type

Example

Description

name

STR

Atlanta Braves

The full name of the home/away team

shortName

STR

ATL

The short name of the home/away team

mediumName

STR

Braves

The medium name of the home/away team

INT

The id of the home/away team

score

Data	Type	Example	Description
inning1	INT	0	The first inning score of the match for home/away team
inning2	INT	1	The second inning score of the match for home/away team
inning3	INT	3	The third inning score of the match for home/away team
inning4	INT	0	The fourth inning score of the match for home/away team
inning5	INT	0	The fifth inning score of the match for home/away team
inning6	INT	0	The sixth inning score of the match for home/away team
inning7	INT	0	The seventh inning score of the match for home/away team
inning8	INT	1	The eighth inning score of the match for home/away team
inning9	INT	0	The ninth inning score of the match for home/away team
regular	INT	5	The regular score of the match for home/away team
extraInning	INT		The extra inning time score of the match for home/away team
current	INT	5	The current score of the match(live and post) for home/away team

status

Data	Type	Example	Description
name	STR	Full Time	The name of the status
shortName	STR	FT	The short name of the status
id	INT	5	The id of the status

tournament

Data	Type	Example	Description
name	STR	Major League Baseball	The name of the tournament
shortName	STR	MLB	The short name of the tournament
id	INT	3	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	254	The id of the stage

round

Data	Type	Example	Description
name	STR	Round 8	The name of the round
shortName	STR	W8	The short name of the round
id	INT	8	The id of the round

Baseball 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+