No Subscription to this function
GET /baseball/get_rounds
Returns all available rounds for a certain season.
Request URL
https://dsg-api.com/clients/{client_name}/baseball/get_rounds?season_id={season_id}&client={client_name}&authkey={client_authkey}
Parameters
authkey
string Required
client authentification key
client
string Required
unique client ID
ftype
string
changes feed type from XML to json (ftype=json)
lang
string
two-character language code, defaults to 'en'
season_id
int Required
season to get the rounds from
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
last_updated
When record was last updated. Format YYYY-MM-DD HH:MM:SS in CET timezone.
name
name of the competition.
teamtype
determines the type of team/competition (male,female,male_youth,female_youth)
type
determines if a competition is between club teams (club) or national teams (international).
rounds
Details about round
current_gameweek
displays the gameweek of nearest match to today
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.
name
name of round
round_id
unique identifier of round.
start_date
start date, format 'yyyy-mm-dd'.
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
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_rounds?season_id={season_id}&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_rounds?season_id={season_id}&client={client_name}&authkey={client_authkey}"
response = requests.get("https://dsg-api.com/clients/{client_name}/baseball/get_rounds?season_id={season_id}&client={client_name}&authkey={client_authkey}", auth=("User", "Password"))
Response Example
200 Success
{"datasportsgroup":{"version":"1.0","sport":"baseball","lang":"en","method":{"method_id":"53","name":"get_rounds"},"competition":{"competition_id":"921","name":"MLB","teamtype":"male","type":"club","format":"domestic_league","area_id":"203","area_name":"United States","last_updated":"2019-01-29 10:26:45","season":{"season_id":"15143","title":"2018","original_name":"MLB","start_date":"2018-03-29","end_date":"2018-11-02","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/921.png","last_updated":"2018-01-07 15:34:47","rounds":[{"round_id":"18319","name":"Regular Season","start_date":"2018-03-29","end_date":"2018-10-31","type":"table","current_gameweek":"","last_updated":"2019-01-07 14:53:04","group":[{"group_id":"4774","name":"American League Central","last_updated":"2018-01-07 15:38:06"},{"group_id":"4775","name":"American League East","last_updated":"2018-01-07 15:38:06"},{"group_id":"4776","name":"American League West","last_updated":"2018-01-07 15:38:06"},{"group_id":"4777","name":"National League Central","last_updated":"2018-01-07 15:38:06"},{"group_id":"4778","name":"National League East","last_updated":"2018-01-07 15:38:06"},{"group_id":"4779","name":"National League West","last_updated":"2018-01-07 15:38:06"}]},{"round_id":"27630","name":"Tiebreaking play-off","start_date":"2018-10-01","end_date":"2018-10-01","type":"cup","current_gameweek":"","last_updated":"2019-01-07 14:52:47"},{"round_id":"18320","name":"Wild Card Playoffs","start_date":"2018-10-03","end_date":"2018-10-04","type":"cup","current_gameweek":"","last_updated":"2018-10-04 08:23:08"},{"round_id":"18321","name":"Division Series","start_date":"2018-10-05","end_date":"2018-10-13","type":"cup","current_gameweek":"","last_updated":"2018-10-14 11:27:35"},{"round_id":"18322","name":"Championship Series","start_date":"2018-10-13","end_date":"2018-10-22","type":"cup","current_gameweek":"","last_updated":"2018-10-23 15:57:29"},{"round_id":"18323","name":"World Series","start_date":"2018-10-24","end_date":"2018-11-02","type":"cup","current_gameweek":"","last_updated":"2018-10-29 10:56:01"}]}}}}