Subscription to this function is not available for your account. To upgrade and receive access to this contact sales@datasportsgroup.com
GET /baseball/get_matches_day
Returns all matches with basic data which will be played at the selected day.
Request URL
https://dsg-api.com/clients/{client_name}/baseball/get_matches_day?day={day}&client={client_name}&authkey={client_authkey}
Parameters
authkey
string Required
client authentification key
client
string Required
unique client ID
day
string Required
date to obtain matches (yyyy-mm-dd)
detailed
string
only 'yes' is valid. This parameter can be only used in connection with either &round_id= or &last_updated= .
ftype
string
changes feed type from XML to json (ftype=json)
lang
string
two-character language code, defaults to 'en'
last_updated
string
by using valid date time format (yyyy-mm-dd hh:mm:ss) it will display only matches updated after this timestamp. The timestampl cant be older than 6 minutes.
playing
string
only 'yes' is valid to display only current live matches
round_id
int
by using a valid round_id it will filter the todays matches
Nodes
competition
Details about competition
area_id
unique identifier for area.
area_name
contains the area name.
competition_id
unique identifier for a competition.
format
competition format to filter out leagues or cups
gender
determines the gender of the competition (male or female)
last_updated
When record was last updated. Format YYYY-MM-DD HH:MM:SS in CET timezone.
name
name of the competition.
type
determines if a competition is between club teams (club) or national teams (international).
datasportsgroup
details about the API version, sport, language and generation timestamp
generated_utc
UTC timestamp when the API output was generated
lang
language of the API
sport
sport of the API
version
version of the API
discipline
Basic information about the discipline
discipline_id
unique identifier of the discipline
name
name of the discipline
type
type of discipline (contestant or team)
gender
details about the gender
value
gender type (male, female or mixed)
live
details about live informations
clock
time on the clock when the event happened (aka how much time was left till the round ends)
game_minute
display during a live match the current game minute
period
current period
match
Details about match
date
Date of match, format 'yyyy-mm-dd' (CET)
date_utc
Date of match, format 'yyyy-mm-dd' (UTC)
final_period
display the period in which the match finished. ('soc_p2s','soc_ets','soc_pen')
last_updated
When record was last updated. Format YYYY-MM-DD HH:MM:SS in CET timezone.
match_id
unique identifier of match.
score_a
full-time score of home team, including any goals in extra-time
score_b
full-time score of home team, including any goals in extra-time
status
status of the game (Playing, Break, Played, Fixture, Postponed, Awarded, Cancelled, Suspended)
team_a_area_code
three-letter-acronym of the area where the home team origins.
team_a_id
unique team ID for the home team.
team_a_logo
URL to the team logo
team_a_name
current name of the home team.
team_a_original_name
the real name at the particular season (so can differ to current name)
team_a_short_name
short name of the home team.
team_a_tla_name
three-letter-acronym of the home team.
team_b_area_code
three-letter-acronym of the area where the home team origins.
team_b_id
unique team ID for the away team.
team_b_logo
URL to the team logo
team_b_name
current name of the away team.
team_b_original_name
the real name at the particular season (so can differ to current name)
team_b_short_name
short name of the away team.
team_b_tla_name
three-letter-acronym of the away team.
time
start time (CET), format 'hh:mm:ss'.
time_utc
start time (UTC), format 'hh:mm:ss'.
venue_type
determines if the match is on neutral ground or on home/away basis
winner
determines the winner of match ('team_A','team_B','draw','yet unknown')
match_extra
Details about extra match informations
attendance
amount of people that attended the particular match
gameweek
contains the gameweek a match belongs to.
method
details about the API function
method_id
unique ID of method.
name
name of method.
period
Details about periods of the match
score_a
period score of team A
score_b
period score of team B
type
three-letter-acronym of the period
round
Details about round
end_date
end date, format 'yyyy-mm-dd'.
end_date_utc
end date in UTC timezone, format 'yyyy-mm-dd'.
end_time
end time, format 'HH:mm:ss'. (Berlin/Amsterdam)
end_time_utc
end time in UTC timezone, format 'HH:mm:ss'.
last_updated
When record was last updated. Format YYYY-MM-DD HH:MM:SS in CET timezone.
name
name of round
round_id
unique identifier of round.
start_date
start date, format 'yyyy-mm-dd'.
start_date_utc
start date in UTC timezone, format 'yyyy-mm-dd'.
start_time
start time, format 'HH:mm:ss'.
start_time_utc
start time in UTC timezone, format 'HH:mm:ss'.
type
Determines if the round contains a table or a cup structure (knock-out).
season
Details about season
end_date
end date, format 'yyyy-mm-dd'.
last_updated
when record was last updated. Format YYYY-MM-DD HH:MM:SS in CET timezone.
logo
full path URL of logo for particular season
original_name
competition name during this season
season_id
unique identifier for season.
start_date
start date, format 'yyyy-mm-dd'.
title
title of season
venue
Details about the venue
venue_area_id
unique identifier for an area
venue_area_name
name of the area
venue_city
city where the venue is based
venue_id
Unique identifier of the venue
venue_name
current name of the venue
Response Headers
200
Success
401
Unauthorized
429
Too Many Requests
Code Samples
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://dsg-api.com/clients/{client_name}/baseball/get_matches_day?day={day}&client={client_name}&authkey={client_authkey}");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_USERPWD, "{User}:{Password}");
$content = curl_exec($ch);
curl_close($ch);
?>
curl GET -u "User:Password" "https://dsg-api.com/clients/{client_name}/baseball/get_matches_day?day={day}&client={client_name}&authkey={client_authkey}"
Imports System
Imports System.Net	
Imports System.IO
Imports System.Text

Public Module Module1
	Public Sub Main()
		Dim url As String = "https://dsg-api.com/clients/{client_name}/baseball/get_matches_day?day={day}&client={client_name}&authkey={client_authkey}"
		Dim myReq As WebRequest = WebRequest.Create(url)
		myReq.Credentials = new System.Net.NetworkCredential("{User}", "{Password}")
		Dim wr As WebResponse = myReq.GetResponse()
		Dim receiveStream As Stream = wr.GetResponseStream()
		Dim reader As StreamReader = New StreamReader(receiveStream, Encoding.UTF8)
		Dim content As String = reader.ReadToEnd()
	End Sub
End Module
response = requests.get("https://dsg-api.com/clients/{client_name}/baseball/get_matches_day?day={day}&client={client_name}&authkey={client_authkey}", auth=("User", "Password"))
Response Example
200 Success
{"datasportsgroup":{"version":"1.1","sport":"baseball","lang":"","method":{"method_id":"61","name":"get_matches_day"},"competition":[{"competition_id":"921","competition_name":"MLB","competition_area_id":"203","area_name":"United States","season_id":"20045","season_title":"2019","round_id":"27415","parent_area_id":"4","match":[{"match_id":"1514434","date":"2019-08-08","time":"00:40:00","date_utc":"2019-08-07","time_utc":"22:40:00","team_a_id":"25462","team_a_name":"Seattle Mariners","team_a_short_name":"Mariners","team_a_tla_name":"SEA","team_a_original_name":"Seattle Mariners","team_a_country":"USA","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/25462.png","team_b_id":"25507","team_b_name":"San Diego Padres","team_b_short_name":"Padres","team_b_tla_name":"SDN","team_b_original_name":"San Diego Padres","team_b_country":"USA","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/25507.png","status":"Played","gameweek":"","winner":"team_A","runs_a":"3","runs_b":"2","p1s_a":"0","p1s_b":"1","p2s_a":"1","p2s_b":"0","p3s_a":"0","p3s_b":"0","p4s_a":"1","p4s_b":"0","p5s_a":"0","p5s_b":"0","p6s_a":"0","p6s_b":"1","p7s_a":"0","p7s_b":"0","p8s_a":"1","p8s_b":"0","p9s_a":"X","p9s_b":"0","hits_a":"7","hits_b":"8","errors_a":"0","errors_b":"1","venue_type":"home_away","final_period":"bas_p9s","attendance":"20142","venue_id":"9433","venue_name":"T-Mobile Park","venue_city":"Seattle, WA","last_updated":"2019-08-08 08:00:17"},{"match_id":"1514435","date":"2019-08-08","time":"01:05:00","date_utc":"2019-08-07","time_utc":"23:05:00","team_a_id":"25467","team_a_name":"Pittsburgh Pirates","team_a_short_name":"Pirates","team_a_tla_name":"PIT","team_a_original_name":"Pittsburgh Pirates","team_a_country":"USA","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/25467.png","team_b_id":"25466","team_b_name":"Milwaukee Brewers","team_b_short_name":"Brewers","team_b_tla_name":"MIL","team_b_original_name":"Milwaukee Brewers","team_b_country":"USA","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/25466.png","status":"Played","gameweek":"","winner":"team_B","runs_a":"3","runs_b":"8","p1s_a":"0","p1s_b":"2","p2s_a":"0","p2s_b":"1","p3s_a":"1","p3s_b":"2","p4s_a":"0","p4s_b":"0","p5s_a":"0","p5s_b":"1","p6s_a":"0","p6s_b":"2","p7s_a":"2","p7s_b":"0","p8s_a":"0","p8s_b":"0","p9s_a":"0","p9s_b":"0","hits_a":"6","hits_b":"10","errors_a":"2","errors_b":"2","venue_type":"home_away","final_period":"bas_p9s","attendance":"12885","venue_id":"9425","venue_name":"PNC Park ","venue_city":"Pittsburgh, PA","last_updated":"2019-08-08 08:01:34"},{"match_id":"1514436","date":"2019-08-08","time":"01:05:00","date_utc":"2019-08-07","time_utc":"23:05:00","team_a_id":"25454","team_a_name":"Baltimore Orioles","team_a_short_name":"Orioles","team_a_tla_name":"BAL","team_a_original_name":"Baltimore Orioles","team_a_country":"USA","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/25454.png","team_b_id":"25456","team_b_name":"New York Yankees","team_b_short_name":"Yankees","team_b_tla_name":"NYA","team_b_original_name":"New York Yankees","team_b_country":"USA","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/25456.png","status":"Played","gameweek":"","winner":"team_B","runs_a":"2","runs_b":"14","p1s_a":"0","p1s_b":"0","p2s_a":"0","p2s_b":"0","p3s_a":"0","p3s_b":"0","p4s_a":"1","p4s_b":"4","p5s_a":"0","p5s_b":"2","p6s_a":"0","p6s_b":"5","p7s_a":"0","p7s_b":"0","p8s_a":"0","p8s_b":"0","p9s_a":"1","p9s_b":"3","hits_a":"6","hits_b":"15","errors_a":"2","errors_b":"0","venue_type":"home_away","final_period":"bas_p9s","attendance":"16299","venue_id":"9418","venue_name":"Oriole Park at Camden Yards","venue_city":"Baltimore, MD","last_updated":"2019-08-08 08:00:58"},{"match_id":"1514412","date":"2019-08-08","time":"01:10:00","date_utc":"2019-08-07","time_utc":"23:10:00","team_a_id":"25448","team_a_name":"Cleveland Indians","team_a_short_name":"Indians","team_a_tla_name":"CLE","team_a_original_name":"Cleveland Indians","team_a_country":"USA","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/25448.png","team_b_id":"25463","team_b_name":"Texas Rangers","team_b_short_name":"Rangers","team_b_tla_name":"TEX","team_b_original_name":"Texas Rangers","team_b_country":"USA","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/25463.png","status":"Played","gameweek":"","winner":"team_A","runs_a":"5","runs_b":"1","p1s_a":"0","p1s_b":"0","p2s_a":"1","p2s_b":"0","p3s_a":"0","p3s_b":"0","p4s_a":"0","p4s_b":"0","p5s_a":"0","p5s_b":"0","p6s_a":"0","p6s_b":"0","p7s_a":"1","p7s_b":"0","p8s_a":"3","p8s_b":"1","p9s_a":"X","p9s_b":"0","hits_a":"9","hits_b":"4","errors_a":"1","errors_b":"0","venue_type":"home_away","final_period":"bas_p9s","attendance":"24888","venue_id":"9432","venue_name":"Progressive Field","venue_city":"Cleveland, OH","last_updated":"2019-08-08 07:55:17"},{"match_id":"1514438","date":"2019-08-08","time":"03:40:00","date_utc":"2019-08-08","time_utc":"01:40:00","team_a_id":"25504","team_a_name":"Arizona Diamondbacks","team_a_short_name":"Diamondbacks","team_a_tla_name":"ARI","team_a_original_name":"Arizona Diamondbacks","team_a_country":"USA","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/25504.png","team_b_id":"25472","team_b_name":"Philadelphia Phillies","team_b_short_name":"Phillies","team_b_tla_name":"PHI","team_b_original_name":"Philadelphia Phillies","team_b_country":"USA","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/25472.png","status":"Played","gameweek":"","winner":"team_A","runs_a":"6","runs_b":"1","p1s_a":"0","p1s_b":"0","p2s_a":"0","p2s_b":"0","p3s_a":"2","p3s_b":"0","p4s_a":"2","p4s_b":"0","p5s_a":"0","p5s_b":"0","p6s_a":"0","p6s_b":"0","p7s_a":"0","p7s_b":"0","p8s_a":"2","p8s_b":"0","p9s_a":"X","p9s_b":"1","hits_a":"8","hits_b":"5","errors_a":"0","errors_b":"2","venue_type":"home_away","final_period":"bas_p9s","attendance":"18140","venue_id":"4495","venue_name":"Chase Field","venue_city":"Phoenix, AZ","last_updated":"2019-08-08 08:02:11"}]},{"competition_id":"1845","competition_name":"NPB","competition_area_id":"102","area_name":"Japan","season_id":"20680","season_title":"2019","round_id":"28530","parent_area_id":"2","match":[{"match_id":"1576743","date":"2019-08-08","time":"11:00:00","date_utc":"2019-08-08","time_utc":"09:00:00","team_a_id":"35582","team_a_name":"Chunichi Dragons","team_a_short_name":"Chunichi Drag","team_a_tla_name":"CHU","team_a_original_name":"Chunichi Dragons","team_a_country":"JPN","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/35582.png","team_b_id":"35581","team_b_name":"Yomiuri Giants","team_b_short_name":"Yomiuri Giants","team_b_tla_name":"YOM","team_b_original_name":"Yomiuri Giants","team_b_country":"JPN","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/35581.png","status":"Playing","gameweek":"","winner":"yet unknown","runs_a":"3","runs_b":"3","p1s_a":"0","p1s_b":"0","p2s_a":"0","p2s_b":"0","p3s_a":"0","p3s_b":"0","p4s_a":"0","p4s_b":"2","p5s_a":"0","p5s_b":"1","p6s_a":"1","p6s_b":"0","p7s_a":"0","p7s_b":"0","p8s_a":"2","p8s_b":"0","p9s_a":"0","p9s_b":"0","ep1s_a":"0","ep1s_b":"0","ep2s_a":"0","ep2s_b":"0","ep3s_a":"0","ep3s_b":"0","hits_a":"8","hits_b":"4","errors_a":"1","errors_b":"0","venue_type":"home_away","final_period":"bas_ep3s","attendance":"30837","venue_id":"11591","venue_name":"Nagoya Dome","venue_city":"Nagoya","last_updated":"2019-08-08 14:48:02"},{"match_id":"1576745","date":"2019-08-08","time":"11:00:00","date_utc":"2019-08-08","time_utc":"09:00:00","team_a_id":"35579","team_a_name":"Hokkaido Nippon-Ham Fighters","team_a_short_name":"Nippon-Ham","team_a_tla_name":"NIP","team_a_original_name":"Hokkaido Nippon-Ham Fighters","team_a_country":"JPN","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/35579.png","team_b_id":"35578","team_b_name":"Orix Buffaloes","team_b_short_name":"Orix Buffaloes","team_b_tla_name":"ORX","team_b_original_name":"Orix Buffaloes","team_b_country":"JPN","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/35578.png","status":"Played","gameweek":"","winner":"team_B","runs_a":"2","runs_b":"5","p1s_a":"0","p1s_b":"1","p2s_a":"0","p2s_b":"0","p3s_a":"0","p3s_b":"0","p4s_a":"0","p4s_b":"2","p5s_a":"0","p5s_b":"0","p6s_a":"1","p6s_b":"0","p7s_a":"1","p7s_b":"0","p8s_a":"0","p8s_b":"0","p9s_a":"0","p9s_b":"2","hits_a":"4","hits_b":"10","errors_a":"2","errors_b":"0","venue_type":"home_away","final_period":"bas_p9s","attendance":"15395","venue_id":"14258","venue_name":"Hanasaki Sports Park Baseball Field","venue_city":"Asahikawa-shi","last_updated":"2019-08-08 14:29:05"},{"match_id":"1576746","date":"2019-08-08","time":"11:00:00","date_utc":"2019-08-08","time_utc":"09:00:00","team_a_id":"35576","team_a_name":"Saitama Seibu Lions","team_a_short_name":"Saitama Seibu","team_a_tla_name":"SAI","team_a_original_name":"Saitama Seibu Lions","team_a_country":"JPN","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/35576.png","team_b_id":"35577","team_b_name":"Tohoku Rakuten Golden Eagles","team_b_short_name":"Rakuten GE","team_b_tla_name":"RGE","team_b_original_name":"Tohoku Rakuten Golden Eagles","team_b_country":"JPN","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/35577.png","status":"Playing","gameweek":"","winner":"yet unknown","runs_a":"6","runs_b":"6","p1s_a":"0","p1s_b":"2","p2s_a":"0","p2s_b":"0","p3s_a":"2","p3s_b":"3","p4s_a":"0","p4s_b":"0","p5s_a":"2","p5s_b":"0","p6s_a":"0","p6s_b":"1","p7s_a":"2","p7s_b":"0","p8s_a":"0","p8s_b":"0","p9s_a":"0","p9s_b":"0","hits_a":"11","hits_b":"10","errors_a":"2","errors_b":"0","venue_type":"home_away","final_period":"bas_p9s","attendance":"17910","venue_id":"14239","venue_name":"Omiya Park Baseball Stadium","venue_city":"Saitama-shi","last_updated":"2019-08-08 14:46:11"},{"match_id":"1582730","date":"2019-08-08","time":"11:00:00","date_utc":"2019-08-08","time_utc":"09:00:00","team_a_id":"35574","team_a_name":"Tokyo Yakult Swallows","team_a_short_name":"Tokyo Yakult","team_a_tla_name":"TYS","team_a_original_name":"Tokyo Yakult Swallows","team_a_country":"JPN","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/35574.png","team_b_id":"35572","team_b_name":"Hanshin Tigers","team_b_short_name":"Hanshin Tigers","team_b_tla_name":"HAN","team_b_original_name":"Hanshin Tigers","team_b_country":"JPN","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/35572.png","status":"Played","gameweek":"","winner":"team_B","runs_a":"3","runs_b":"5","p1s_a":"0","p1s_b":"0","p2s_a":"0","p2s_b":"0","p3s_a":"1","p3s_b":"0","p4s_a":"0","p4s_b":"0","p5s_a":"1","p5s_b":"0","p6s_a":"0","p6s_b":"3","p7s_a":"0","p7s_b":"0","p8s_a":"0","p8s_b":"0","p9s_a":"1","p9s_b":"2","hits_a":"7","hits_b":"10","errors_a":"1","errors_b":"0","venue_type":"home_away","final_period":"bas_p9s","attendance":"30417","venue_id":"11598","venue_name":"Meiji Jingu Stadium","venue_city":"Tōkyō","last_updated":"2019-08-08 14:32:17"},{"match_id":"1582732","date":"2019-08-08","time":"11:00:00","date_utc":"2019-08-08","time_utc":"09:00:00","team_a_id":"35571","team_a_name":"Hiroshima Toyo Carp","team_a_short_name":"Hiroshima TC","team_a_tla_name":"HTC","team_a_original_name":"Hiroshima Toyo Carp","team_a_country":"JPN","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/35571.png","team_b_id":"35573","team_b_name":"Yokohama DeNA BayStars","team_b_short_name":"Yokohama BS","team_b_tla_name":"YOK","team_b_original_name":"Yokohama DeNA BayStars","team_b_country":"JPN","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/35573.png","status":"Played","gameweek":"","winner":"team_A","runs_a":"4","runs_b":"1","p1s_a":"0","p1s_b":"0","p2s_a":"0","p2s_b":"0","p3s_a":"0","p3s_b":"0","p4s_a":"1","p4s_b":"0","p5s_a":"3","p5s_b":"0","p6s_a":"0","p6s_b":"0","p7s_a":"0","p7s_b":"0","p8s_a":"0","p8s_b":"0","p9s_a":"X","p9s_b":"1","hits_a":"6","hits_b":"2","errors_a":"1","errors_b":"0","venue_type":"home_away","final_period":"bas_p9s","attendance":"31330","venue_id":"11594","venue_name":"Mazda Zoom-Zoom Stadium","venue_city":"Hiroshima","last_updated":"2019-08-08 14:14:20"},{"match_id":"1576747","date":"2019-08-08","time":"11:15:00","date_utc":"2019-08-08","time_utc":"09:15:00","team_a_id":"35580","team_a_name":"Chiba Lotte Marines","team_a_short_name":"Chiba Lotte","team_a_tla_name":"CHB","team_a_original_name":"Chiba Lotte Marines","team_a_country":"JPN","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/35580.png","team_b_id":"35575","team_b_name":"Fukuoka SoftBank Hawks","team_b_short_name":"Fukuoka SB","team_b_tla_name":"FUK","team_b_original_name":"Fukuoka SoftBank Hawks","team_b_country":"JPN","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/35575.png","status":"Playing","gameweek":"","winner":"yet unknown","runs_a":"3","runs_b":"5","p1s_a":"0","p1s_b":"0","p2s_a":"2","p2s_b":"0","p3s_a":"0","p3s_b":"0","p4s_a":"0","p4s_b":"0","p5s_a":"1","p5s_b":"1","p6s_a":"0","p6s_b":"0","p7s_a":"0","p7s_b":"3","p8s_a":"0","p8s_b":"1","p9s_a":"","p9s_b":"0","hits_a":"8","hits_b":"7","errors_a":"0","errors_b":"1","venue_type":"home_away","final_period":"bas_p9s","attendance":"25771","venue_id":"11590","venue_name":"Zozo Marine Stadium","venue_city":"Chiba-shi","last_updated":"2019-08-08 14:48:10"}]}]}}