No Subscription to this function
GET /handball/get_season_team
Returns all teams which are of the seasons
Request URL
https://dsg-api.com/clients/{client_name}/handball/get_season_team?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)
season_id
int Required
season id to get teams 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).
method
details about the API function
method_id
unique ID of method.
name
name of method.
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
team
basic team informations
gender
gender of the team ('male', 'male youth', 'female' or 'female youth')
last_updated
when record was last updated. Format YYYY-MM-DD HH:MM:SS in CET timezone.
original_team_name
original team name during the season
short_name
short name of the team.
status
The current status of the team ('active' or 'defunct')
team_id
Unique identifier for team
team_logo
full path URL of team logo
team_name
current team name
type
Determines the type of team ('national' or 'club')
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}/handball/get_season_team?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}/handball/get_season_team?season_id={season_id}&client={client_name}&authkey={client_authkey}"
response = requests.get("https://dsg-api.com/clients/{client_name}/handball/get_season_team?season_id={season_id}&client={client_name}&authkey={client_authkey}", auth=("User", "Password"))
Response Example
200 Success
{"datasportsgroup":{"version":"1.0","sport":"handball","lang":"en","method":{"method_id":"140","name":"get_season_team"},"competition":{"competition_id":"1491","name":"Handball Bundesliga","teamtype":"male","type":"club","format":"domestic_league","area_id":"80","area_name":"Germany","last_updated":"2019-08-07 09:59:25","season":{"season_id":"17053","title":"2018\/2019","original_name":"DKB Handball Bundesliga","start_date":"2018-08-23","end_date":"2019-06-09","last_updated":"2018-08-17 14:43:06","team":[{"team_id":"26518","team_name":"Bergischer HC","original_team_name":"Bergischer HC","short_name":"Bergischer HC","type":"club","gender":"male","status":"active","team_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/26518.png","last_updated":"2018-07-02 22:47:45"},{"team_id":"32593","team_name":"Die Eulen Ludwigshafen","original_team_name":"Die Eulen Ludwigshafen","short_name":"Die Eulen","type":"club","gender":"male","status":"active","team_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/32593.png","last_updated":"2017-08-24 22:32:49"},{"team_id":"26504","team_name":"FRISCH AUF! Göppingen","original_team_name":"FRISCH AUF! Göppingen","short_name":"FA Göppingen","type":"club","gender":"male","status":"active","team_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/26504.png","last_updated":"2017-08-24 23:09:42"},{"team_id":"26505","team_name":"Füchse Berlin","original_team_name":"Füchse Berlin","short_name":"Füchse Berlin","type":"club","gender":"male","status":"active","team_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/26505.png","last_updated":"2017-08-10 17:29:29"},{"team_id":"32591","team_name":"GWD Minden","original_team_name":"GWD Minden","short_name":"GWD Minden","type":"club","gender":"male","status":"active","team_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/32591.png","last_updated":"2018-08-24 21:28:40"},{"team_id":"32592","team_name":"HC Erlangen","original_team_name":"HC Erlangen","short_name":"HC Erlangen","type":"club","gender":"male","status":"active","team_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/32592.png","last_updated":"2018-08-25 10:22:04"},{"team_id":"26509","team_name":"HSG Wetzlar","original_team_name":"HSG Wetzlar","short_name":"HSG Wetzlar","type":"club","gender":"male","status":"active","team_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/26509.png","last_updated":"2017-08-10 17:29:20"},{"team_id":"26516","team_name":"MT Melsungen","original_team_name":"MT Melsungen","short_name":"MT Melsungen","type":"club","gender":"male","status":"active","team_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/26516.png","last_updated":"2017-08-24 23:40:52"},{"team_id":"26511","team_name":"Rhein-Neckar Löwen","original_team_name":"Rhein-Neckar Löwen","short_name":"RN Löwen","type":"club","gender":"male","status":"active","team_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/26511.png","last_updated":"2017-08-25 05:05:20"},{"team_id":"26519","team_name":"SC DHfK Leipzig","original_team_name":"SC DHfK Leipzig","short_name":"DHfK Leipzig","type":"club","gender":"male","status":"active","team_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/26519.png","last_updated":"2017-09-04 15:25:05"},{"team_id":"26506","team_name":"SC Magdeburg","original_team_name":"SC Magdeburg","short_name":"SC Magdeburg","type":"club","gender":"male","status":"active","team_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/26506.png","last_updated":"2017-09-04 15:23:40"},{"team_id":"33052","team_name":"SG BBM Bietigheim","original_team_name":"SG BBM Bietigheim","short_name":"BBM Bietigheim","type":"club","gender":"male","status":"active","team_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/33052.png","last_updated":"2018-08-25 11:24:55"},{"team_id":"26512","team_name":"SG Flensburg-Handewitt","original_team_name":"SG Flensburg-Handewitt","short_name":"Flensburg","type":"club","gender":"male","status":"active","team_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/26512.png","last_updated":"2017-08-25 15:13:37"},{"team_id":"26513","team_name":"TBV Lemgo Lippe","original_team_name":"TBV Lemgo","short_name":"TBV Lemgo","type":"club","gender":"male","status":"active","team_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/26513.png","last_updated":"2018-08-24 23:08:44"},{"team_id":"26514","team_name":"THW Kiel","original_team_name":"THW Kiel","short_name":"THW Kiel","type":"club","gender":"male","status":"active","team_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/26514.png","last_updated":"2017-09-04 15:24:27"},{"team_id":"26515","team_name":"TSV Hannover-Burgdorf","original_team_name":"TSV Hannover-Burgdorf","short_name":"Hannover","type":"club","gender":"male","status":"active","team_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/26515.png","last_updated":"2018-08-24 21:10:06"},{"team_id":"26520","team_name":"TVB 1898 Stuttgart","original_team_name":"TVB 1898 Stuttgart","short_name":"TVB Stuttgart","type":"club","gender":"male","status":"active","team_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/26520.png","last_updated":"2017-08-01 01:05:04"},{"team_id":"26517","team_name":"VfL Gummersbach","original_team_name":"VfL Gummersbach","short_name":"Gummersbach","type":"club","gender":"male","status":"active","team_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/26517.png","last_updated":"2017-09-04 15:24:56"}]}}}}