No Subscription to this function
GET /handball/get_team
Returns a list of team details selected from team or season
Request URL
https://dsg-api.com/clients/{client_name}/handball/get_team?team={team_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'
team
int Required
team id to get details from
Nodes
match
Details about next matches of the particular team
attendance
amount of people that attended the particular match
competition_id
unique identifier for a competition.
competition_name
name of the competition.
date
Date of match, format 'yyyy-mm-dd' (CET)
date_utc
Date of match, format 'yyyy-mm-dd' (UTC)
et_a
extra-time score of home team
et_b
extra-time score of away team
final_period
display the period in which the match finished. ('soc_p2s','soc_ets','soc_pen')
gameweek
contains the gameweek a match belongs to.
match_id
unique identifier of match.
p1s_a
half-time score of home team.
p1s_b
half-time score of away team.
p2s_a
2nd half score of home team
p2s_b
2nd half score of away team
pso_a
extra-time score of home team
pso_b
extra-time score of away team
round_id
unique identifier of round
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
season_id
unique identifier of season
status
status of the game (Playing, Break, Played, Fixture, Postponed, Awarded, Cancelled, Suspended)
team_a_country
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_country
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_city
city where the venue is based
venue_id
unique identifier of the venue
venue_name
current name of the venue
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')
method
details about the API function
method_id
unique ID of method.
name
name of method.
related_team
Details about related teams
order
can be used to order the related teams (ascending)
team_id
unique team ID for the team
team_name
current name of the team.
type
type of relation to the main team (reserve, youth, women, related)
team
Basic details about a team
area_id
Unique identifier for area.
area_name
name of area the team is located
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.
short_name
short name of the team.
status
The current status of the team ('active' or 'defunct')
team_id
unique team ID for the team.
team_name
current name of the team.
tla_name
three letter acronym for this team
type
Determines the type of team ('national' or 'club')
team_extra
Extra details about a team
adress
Name of street and street number
adress_city
Name of the city
adress_zip
ZIP code
club_colors
Original colors of club (seperated with / )
email
Official e-mail address.
fax
Fax number
founded
Year club was founded. Format 'yyyy'
nicknames
nickname of the club. Can contain until 3 different ones seperated with a "/"
official_name
The official name of a team
primary_venue_id
venue_id of the home venue or primary used one for the particular team
primary_venue_name
venue name of the home venue or primary used one for the particular team
team_logo
full path URL of team logo
tel
Telephone number
website
Official website address (URL).
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_team?team={team_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_team?team={team_id}&client={client_name}&authkey={client_authkey}"
response = requests.get("https://dsg-api.com/clients/{client_name}/handball/get_team?team={team_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":"147","name":"get_team"},"team":{"team_id":"26504","team_name":"FRISCH AUF! Göppingen","short_name":"FA Göppingen","tla_name":"FAG","type":"club","gender":"male","status":"active","area_id":"80","area_name":"Germany","last_updated":"2017-08-24 23:09:42","team_extra":{"adress":"Leonhard-Weiss-Str. 40","adress_zip":"73037","adress_city":"Göppingen","tel":"","fax":"","website":"http:\/\/www.frischauf-gp.de","email":"service@frischauf-gp.de","official_name":"Frisch Auf Göppingen","founded":"1896","club_colors":"Green \/ White","team_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/26504.png","nicknames":"","primary_venue_id":"8795","primary_venue_name":"EWS Arena"},"team_social_media":{"facebook":"https:\/\/www.facebook.com\/frischaufgp\/","twitter":"https:\/\/twitter.com\/frischaufgp","youtube":"","google_plus":"","instagram":"https:\/\/www.instagram.com\/frischaufgp\/","vk":""},"last_matches":{"match":[{"match_id":"1388424","date":"2019-05-05","time":"16:00:00","date_utc":"2019-05-05","time_utc":"14:00:00","team_a_id":"26513","team_a_name":"TBV Lemgo Lippe","team_a_short_name":"TBV Lemgo","team_a_tla_name":"TBV","team_a_original_name":"TBV Lemgo","team_a_country":"DEU","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/26513.png","team_b_id":"26504","team_b_name":"FRISCH AUF! Göppingen","team_b_short_name":"FA Göppingen","team_b_tla_name":"FAG","team_b_original_name":"FRISCH AUF! Göppingen","team_b_country":"DEU","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/26504.png","status":"Played","gameweek":"29","winner":"team_B","score_a":"25","score_b":"30","p1s_a":"10","p1s_b":"14","p2s_a":"15","p2s_b":"16","et_a":"","et_b":"","so7_a":"","so7_b":"","venue_type":"home_away","final_period":"hbl_p2s","attendance":"4145","venue_id":"8796","venue_name":"Lipperlandhalle","venue_city":"Lemgo","competition_id":"1491","competition_name":"DKB Handball Bundesliga","season_id":"17053","round_id":"22877","last_updated":"2019-08-05 12:00:06"},{"match_id":"1388425","date":"2019-05-09","time":"19:00:00","date_utc":"2019-05-09","time_utc":"17:00:00","team_a_id":"26504","team_a_name":"FRISCH AUF! Göppingen","team_a_short_name":"FA Göppingen","team_a_tla_name":"FAG","team_a_original_name":"FRISCH AUF! Göppingen","team_a_country":"DEU","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/26504.png","team_b_id":"32592","team_b_name":"HC Erlangen","team_b_short_name":"HC Erlangen","team_b_tla_name":"HCE","team_b_original_name":"HC Erlangen","team_b_country":"DEU","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/32592.png","status":"Played","gameweek":"30","winner":"team_A","score_a":"25","score_b":"23","p1s_a":"11","p1s_b":"8","p2s_a":"14","p2s_b":"15","et_a":"","et_b":"","so7_a":"","so7_b":"","venue_type":"home_away","final_period":"hbl_p2s","attendance":"4000","venue_id":"8795","venue_name":"EWS Arena","venue_city":"Göppingen","competition_id":"1491","competition_name":"DKB Handball Bundesliga","season_id":"17053","round_id":"22877","last_updated":"2019-08-05 12:00:06"},{"match_id":"1388448","date":"2019-05-16","time":"19:00:00","date_utc":"2019-05-16","time_utc":"17:00:00","team_a_id":"26504","team_a_name":"FRISCH AUF! Göppingen","team_a_short_name":"FA Göppingen","team_a_tla_name":"FAG","team_a_original_name":"FRISCH AUF! Göppingen","team_a_country":"DEU","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/26504.png","team_b_id":"26509","team_b_name":"HSG Wetzlar","team_b_short_name":"HSG Wetzlar","team_b_tla_name":"WET","team_b_original_name":"HSG Wetzlar","team_b_country":"DEU","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/26509.png","status":"Played","gameweek":"32","winner":"team_B","score_a":"22","score_b":"24","p1s_a":"10","p1s_b":"9","p2s_a":"12","p2s_b":"15","et_a":"","et_b":"","so7_a":"","so7_b":"","venue_type":"home_away","final_period":"hbl_p2s","attendance":"3800","venue_id":"8795","venue_name":"EWS Arena","venue_city":"Göppingen","competition_id":"1491","competition_name":"DKB Handball Bundesliga","season_id":"17053","round_id":"22877","last_updated":"2019-08-05 12:00:06"},{"match_id":"1388434","date":"2019-05-23","time":"19:00:00","date_utc":"2019-05-23","time_utc":"17:00:00","team_a_id":"26511","team_a_name":"Rhein-Neckar Löwen","team_a_short_name":"RN Löwen","team_a_tla_name":"RNL","team_a_original_name":"Rhein-Neckar Löwen","team_a_country":"DEU","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/26511.png","team_b_id":"26504","team_b_name":"FRISCH AUF! Göppingen","team_b_short_name":"FA Göppingen","team_b_tla_name":"FAG","team_b_original_name":"FRISCH AUF! Göppingen","team_b_country":"DEU","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/26504.png","status":"Played","gameweek":"31","winner":"team_A","score_a":"33","score_b":"27","p1s_a":"15","p1s_b":"17","p2s_a":"18","p2s_b":"10","et_a":"","et_b":"","so7_a":"","so7_b":"","venue_type":"home_away","final_period":"hbl_p2s","attendance":"8015","venue_id":"8794","venue_name":"SAP Arena","venue_city":"Mannheim","competition_id":"1491","competition_name":"DKB Handball Bundesliga","season_id":"17053","round_id":"22877","last_updated":"2019-08-05 12:00:06"},{"match_id":"1388459","date":"2019-05-29","time":"18:30:00","date_utc":"2019-05-29","time_utc":"16:30:00","team_a_id":"26517","team_a_name":"VfL Gummersbach","team_a_short_name":"Gummersbach","team_a_tla_name":"GUM","team_a_original_name":"VfL Gummersbach","team_a_country":"DEU","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/26517.png","team_b_id":"26504","team_b_name":"FRISCH AUF! Göppingen","team_b_short_name":"FA Göppingen","team_b_tla_name":"FAG","team_b_original_name":"FRISCH AUF! Göppingen","team_b_country":"DEU","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/26504.png","status":"Played","gameweek":"33","winner":"team_B","score_a":"22","score_b":"26","p1s_a":"13","p1s_b":"14","p2s_a":"9","p2s_b":"12","et_a":"","et_b":"","so7_a":"","so7_b":"","venue_type":"home_away","final_period":"hbl_p2s","attendance":"4132","venue_id":"9147","venue_name":"Schwalbe-Arena","venue_city":"Gummersbach","competition_id":"1491","competition_name":"DKB Handball Bundesliga","season_id":"17053","round_id":"22877","last_updated":"2019-08-05 12:00:06"},{"match_id":"1388465","date":"2019-06-09","time":"15:00:00","date_utc":"2019-06-09","time_utc":"13:00:00","team_a_id":"26504","team_a_name":"FRISCH AUF! Göppingen","team_a_short_name":"FA Göppingen","team_a_tla_name":"FAG","team_a_original_name":"FRISCH AUF! Göppingen","team_a_country":"DEU","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/26504.png","team_b_id":"26506","team_b_name":"SC Magdeburg","team_b_short_name":"SC Magdeburg","team_b_tla_name":"SCM","team_b_original_name":"SC Magdeburg","team_b_country":"DEU","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/26506.png","status":"Played","gameweek":"34","winner":"team_B","score_a":"24","score_b":"31","p1s_a":"12","p1s_b":"18","p2s_a":"12","p2s_b":"13","et_a":"","et_b":"","so7_a":"","so7_b":"","venue_type":"home_away","final_period":"hbl_p2s","attendance":"4600","venue_id":"8795","venue_name":"EWS Arena","venue_city":"Göppingen","competition_id":"1491","competition_name":"DKB Handball Bundesliga","season_id":"17053","round_id":"22877","last_updated":"2019-08-05 12:00:07"}]},"next_matches":{"match":[{"match_id":"1752679","date":"2019-08-25","time":"16:00:00","date_utc":"2019-08-25","time_utc":"14:00:00","team_a_id":"26514","team_a_name":"THW Kiel","team_a_short_name":"THW Kiel","team_a_tla_name":"THW","team_a_original_name":"THW Kiel","team_a_country":"DEU","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/26514.png","team_b_id":"26504","team_b_name":"FRISCH AUF! Göppingen","team_b_short_name":"FA Göppingen","team_b_tla_name":"FAG","team_b_original_name":"FRISCH AUF! Göppingen","team_b_country":"DEU","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/26504.png","status":"Fixture","gameweek":"1","winner":"yet unknown","score_a":"","score_b":"","p1s_a":"","p1s_b":"","p2s_a":"","p2s_b":"","et_a":"","et_b":"","so7_a":"","so7_b":"","venue_type":"home_away","final_period":"hbl_p2s","attendance":"","venue_id":"8793","venue_name":"Sparkassen-Arena","venue_city":"Kiel","competition_id":"1491","competition_name":"Liqui Moly Handball Bundesliga","season_id":"23490","round_id":"34762","last_updated":"2019-08-07 10:05:20"},{"match_id":"1752687","date":"2019-08-31","time":"20:30:00","date_utc":"2019-08-31","time_utc":"18:30:00","team_a_id":"26504","team_a_name":"FRISCH AUF! Göppingen","team_a_short_name":"FA Göppingen","team_a_tla_name":"FAG","team_a_original_name":"FRISCH AUF! Göppingen","team_a_country":"DEU","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/26504.png","team_b_id":"26515","team_b_name":"TSV Hannover-Burgdorf","team_b_short_name":"Hannover","team_b_tla_name":"TSV","team_b_original_name":"TSV Hannover-Burgdorf","team_b_country":"DEU","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/26515.png","status":"Fixture","gameweek":"2","winner":"yet unknown","score_a":"","score_b":"","p1s_a":"","p1s_b":"","p2s_a":"","p2s_b":"","et_a":"","et_b":"","so7_a":"","so7_b":"","venue_type":"home_away","final_period":"hbl_p2s","attendance":"","venue_id":"8795","venue_name":"EWS Arena","venue_city":"Göppingen","competition_id":"1491","competition_name":"Liqui Moly Handball Bundesliga","season_id":"23490","round_id":"34762","last_updated":"2019-08-08 08:34:08"},{"match_id":"1752692","date":"2019-09-03","time":"19:00:00","date_utc":"2019-09-03","time_utc":"17:00:00","team_a_id":"32592","team_a_name":"HC Erlangen","team_a_short_name":"HC Erlangen","team_a_tla_name":"HCE","team_a_original_name":"HC Erlangen","team_a_country":"DEU","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/32592.png","team_b_id":"26504","team_b_name":"FRISCH AUF! Göppingen","team_b_short_name":"FA Göppingen","team_b_tla_name":"FAG","team_b_original_name":"FRISCH AUF! Göppingen","team_b_country":"DEU","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/26504.png","status":"Fixture","gameweek":"3","winner":"yet unknown","score_a":"","score_b":"","p1s_a":"","p1s_b":"","p2s_a":"","p2s_b":"","et_a":"","et_b":"","so7_a":"","so7_b":"","venue_type":"home_away","final_period":"hbl_p2s","attendance":"","venue_id":"7616","venue_name":"Arena Nürnberger Versicherung","venue_city":"Nürnberg","competition_id":"1491","competition_name":"Liqui Moly Handball Bundesliga","season_id":"23490","round_id":"34762","last_updated":"2019-08-08 08:34:08"},{"match_id":"1752705","date":"2019-09-08","time":"13:30:00","date_utc":"2019-09-08","time_utc":"11:30:00","team_a_id":"26504","team_a_name":"FRISCH AUF! Göppingen","team_a_short_name":"FA Göppingen","team_a_tla_name":"FAG","team_a_original_name":"FRISCH AUF! Göppingen","team_a_country":"DEU","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/26504.png","team_b_id":"26505","team_b_name":"Füchse Berlin","team_b_short_name":"Füchse Berlin","team_b_tla_name":"BER","team_b_original_name":"Füchse Berlin","team_b_country":"DEU","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/26505.png","status":"Fixture","gameweek":"4","winner":"yet unknown","score_a":"","score_b":"","p1s_a":"","p1s_b":"","p2s_a":"","p2s_b":"","et_a":"","et_b":"","so7_a":"","so7_b":"","venue_type":"home_away","final_period":"hbl_p2s","attendance":"","venue_id":"8795","venue_name":"EWS Arena","venue_city":"Göppingen","competition_id":"1491","competition_name":"Liqui Moly Handball Bundesliga","season_id":"23490","round_id":"34762","last_updated":"2019-08-08 08:34:08"},{"match_id":"1752716","date":"2019-09-15","time":"16:00:00","date_utc":"2019-09-15","time_utc":"14:00:00","team_a_id":"26519","team_a_name":"SC DHfK Leipzig","team_a_short_name":"DHfK Leipzig","team_a_tla_name":"LEI","team_a_original_name":"SC DHfK Leipzig","team_a_country":"DEU","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/26519.png","team_b_id":"26504","team_b_name":"FRISCH AUF! Göppingen","team_b_short_name":"FA Göppingen","team_b_tla_name":"FAG","team_b_original_name":"FRISCH AUF! Göppingen","team_b_country":"DEU","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/26504.png","status":"Fixture","gameweek":"5","winner":"yet unknown","score_a":"","score_b":"","p1s_a":"","p1s_b":"","p2s_a":"","p2s_b":"","et_a":"","et_b":"","so7_a":"","so7_b":"","venue_type":"home_away","final_period":"hbl_p2s","attendance":"","venue_id":"11416","venue_name":"Arena Leipzig","venue_city":"Leipzig","competition_id":"1491","competition_name":"Liqui Moly Handball Bundesliga","season_id":"23490","round_id":"34762","last_updated":"2019-08-08 08:34:08"},{"match_id":"1752720","date":"2019-09-19","time":"19:00:00","date_utc":"2019-09-19","time_utc":"17:00:00","team_a_id":"26504","team_a_name":"FRISCH AUF! Göppingen","team_a_short_name":"FA Göppingen","team_a_tla_name":"FAG","team_a_original_name":"FRISCH AUF! Göppingen","team_a_country":"DEU","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/26504.png","team_b_id":"32591","team_b_name":"GWD Minden","team_b_short_name":"GWD Minden","team_b_tla_name":"GWD","team_b_original_name":"TSV GWD Minden","team_b_country":"DEU","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/32591.png","status":"Fixture","gameweek":"6","winner":"yet unknown","score_a":"","score_b":"","p1s_a":"","p1s_b":"","p2s_a":"","p2s_b":"","et_a":"","et_b":"","so7_a":"","so7_b":"","venue_type":"home_away","final_period":"hbl_p2s","attendance":"","venue_id":"8795","venue_name":"EWS Arena","venue_city":"Göppingen","competition_id":"1491","competition_name":"Liqui Moly Handball Bundesliga","season_id":"23490","round_id":"34762","last_updated":"2019-08-08 08:34:08"}]}}}}