No Subscription to this function
GET /cricket/get_seasons
Returns all (authorized) seasons (that have been recently updated).
Request URL
https://dsg-api.com/clients/{client_name}/cricket/get_seasons?comp_id={competition_id}&client={client_name}&authkey={client_authkey}
Parameters
authkey
string Required
client authentification key
client
string Required
unique client ID
comp_id
int Required
competition id to get seasons from
ftype
string
changes feed type from XML to json (ftype=json)
lang
string
two-character language code, defaults to 'en'
Nodes
competition
Details about competition
area_id
unique identifier for area.
area_name
contains the area name.
competition_id
unique identifier for a competition.
cricket_type
valid values are "T20", "ODI" and "Test"
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).
method
details about the API function
method_id
unique ID of method.
name
name of method.
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
Rate limit exceeded
Code Samples
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://dsg-api.com/clients/{client_name}/cricket/get_seasons?comp_id={competition_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}/cricket/get_seasons?comp_id={competition_id}&client={client_name}&authkey={client_authkey}"
response = requests.get("https://dsg-api.com/clients/{client_name}/cricket/get_seasons?comp_id={competition_id}&client={client_name}&authkey={client_authkey}", auth=("User", "Password"))
Response Example
200 Success
{"datasportsgroup":{"version":"1.0","sport":"cricket","lang":"en","method":{"method_id":"30","name":"get_seasons"},"competition":{"competition_id":"1048","name":"Indian Premier League","teamtype":"male","type":"club","format":"domestic_league","area_id":"94","area_name":"India","cricket_type":"T20","last_updated":"2018-06-10 14:08:49","season":[{"season_id":"20972","title":"2019","original_name":"VIVO IPL","start_date":"2019-03-23","end_date":"2019-05-20","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/1048.png","last_updated":"2019-02-23 15:06:21"},{"season_id":"15641","title":"2018","original_name":"VIVO IPL","start_date":"2018-04-07","end_date":"2018-05-27","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/1048.png","last_updated":"2018-02-26 12:44:53"},{"season_id":"12788","title":"2017","original_name":"Vivo IPL","start_date":"2017-04-05","end_date":"2017-05-21","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/1048.png","last_updated":"2017-02-22 16:16:51"},{"season_id":"12713","title":"2016","original_name":"Vivo IPL","start_date":"2016-04-09","end_date":"2016-05-29","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/1048.png","last_updated":"2017-02-12 22:25:04"},{"season_id":"12933","title":"2015","original_name":"Pepsi IPL","start_date":"2015-04-08","end_date":"2015-05-24","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/1048.png","last_updated":"2017-03-09 21:38:33"},{"season_id":"12934","title":"2014","original_name":"Pepsi IPL","start_date":"2014-04-16","end_date":"2014-06-01","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/1048.png","last_updated":"2017-03-09 22:07:33"},{"season_id":"12935","title":"2013","original_name":"Pepsi IPL","start_date":"2013-04-03","end_date":"2013-05-26","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/1048.png","last_updated":"2017-03-09 22:33:24"},{"season_id":"12936","title":"2012","original_name":"DLF IPL","start_date":"2012-04-04","end_date":"2012-05-27","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/1048.png","last_updated":"2017-03-09 23:11:56"},{"season_id":"12937","title":"2011","original_name":"IPL","start_date":"2011-04-08","end_date":"2011-05-28","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/1048.png","last_updated":"2017-03-10 13:16:16"},{"season_id":"12938","title":"2010","original_name":"IPL","start_date":"2010-03-12","end_date":"2010-04-25","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/1048.png","last_updated":"2017-03-10 14:42:56"},{"season_id":"12939","title":"2009","original_name":"IPL","start_date":"2009-04-18","end_date":"2009-05-24","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/1048.png","last_updated":"2017-03-10 15:16:18"},{"season_id":"12869","title":"2008","original_name":"IPL","start_date":"2008-04-18","end_date":"2008-06-01","logo":"https:\/\/www.dsg-images.com\/comps\/200x200\/1048.png","last_updated":"2017-03-10 13:16:29"}]}}}