No Subscription to this function
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_name
area name of the competition
competition_area_id
area_id of the competition
competition_id
unique identifier for a competition.
competiton_name
title of the competition
original_name
competition name during this season
parent_area_id
unique identifier of the parent area (either continent or World)
round_id
unique identifier of round.
season_id
unique identifier for season
season_title
title of season
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.
match_id
unique identifier of match.
runs_a
full-time score of home team, including any goals in extra-time
runs_b
full-time score of away team, including any goals in extra-time
status
status of the game (Playing, Break, Played, Fixture, Postponed, Awarded, Cancelled, Suspended)
team_a_areaname
area name of home team origins county
team_a_id
unique team ID for the home team.
team_a_name
current name of the home team.
team_b_areaname
area name of away team origins county
team_b_id
unique team ID for the away team.
team_b_name
current name of the away team.
time
start time (CET), format 'hh:mm:ss'.
time_utc
start time (UTC), format 'hh:mm:ss'.
method
details about the API function
method_id
unique ID of method.
name
name of method.
Response Headers
200
Success
401
Unauthorized
429
Rate limit exceeded
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}"
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"}]}]}}