No Subscription to this function
GET /ice_hockey/get_team
Returns a list of team details selected from team or season
Request URL
https://dsg-api.com/clients/{client_name}/ice_hockey/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)
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)
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.
ot_a
over-time period score of home team.
ot_b
over-time period score of away team.
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
p3s_a
3rd period score of home team.
p3s_b
3rd period 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
so_a
shoot out period score of home team.
so_b
shoot out period score of away team.
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}/ice_hockey/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}/ice_hockey/get_team?team={team_id}&client={client_name}&authkey={client_authkey}"
response = requests.get("https://dsg-api.com/clients/{client_name}/ice_hockey/get_team?team={team_id}&client={client_name}&authkey={client_authkey}", auth=("User", "Password"))
Response Example
200 Success
{"datasportsgroup":{"version":"1.0","sport":"ice_hockey","lang":"en","method":{"method_id":"131","name":"get_team"},"team":{"team_id":"25571","team_name":"HC Dinamo Minsk","short_name":"Dinamo Minsk","tla_name":"DIN","type":"club","gender":"male","status":"active","area_id":"26","area_name":"Belarus","last_updated":"2016-09-03 03:02:29","team_extra":{"adress":"Pobeditelei prosp. 111","adress_zip":"220020","adress_city":"Minsk","tel":"+375 (17) 2790885","fax":"","website":"http:\/\/hcdinamo.by","email":"office@hcdinamo.by","official_name":"","founded":"","club_colors":"","team_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/25571.png","nicknames":"","primary_venue_id":"","primary_venue_name":""},"team_social_media":{"facebook":"https:\/\/www.facebook.com\/hockeyclubdinamominsk","twitter":"https:\/\/twitter.com\/hc_dinamominsk","youtube":"http:\/\/www.youtube.com\/user\/hcdinamoby","google_plus":"","instagram":"http:\/\/instagram.com\/hc_dinamominsk","vk":"http:\/\/vk.com\/hc_dinamominsk"},"last_matches":{"match":[{"match_id":"1421311","date":"2019-02-11","time":"17:30:00","date_utc":"2019-02-11","time_utc":"16:30:00","team_a_id":"25571","team_a_name":"HC Dinamo Minsk","team_a_short_name":"Dinamo Minsk","team_a_tla_name":"DIN","team_a_original_name":"HC Dinamo Minsk","team_a_country":"BLR","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/25571.png","team_b_id":"25581","team_b_name":"Lokomotiv Yaroslavl","team_b_short_name":"Lok Yaroslavl","team_b_tla_name":"LOK","team_b_original_name":"Lokomotiv Yaroslavl","team_b_country":"RUS","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/25581.png","status":"Played","gameweek":"","winner":"team_B","score_a":"0","score_b":"3","p1s_a":"0","p1s_b":"0","p2s_a":"0","p2s_b":"3","p3s_a":"0","p3s_b":"0","ot_a":"","ot_b":"","so_a":"","so_b":"","venue_type":"home_away","final_period":"ice_p3s","attendance":"8515","venue_id":"9177","venue_name":"Minsk-Arena","venue_city":"Minsk","competition_id":"975","competition_name":"KHL","season_id":"17941","round_id":"23640","last_updated":"2019-02-11 23:58:17"},{"match_id":"1421323","date":"2019-02-13","time":"18:30:00","date_utc":"2019-02-13","time_utc":"17:30:00","team_a_id":"25576","team_a_name":"HK Slovan Bratislava","team_a_short_name":"Slovan Bratisl","team_a_tla_name":"SLV","team_a_original_name":"HK Slovan Bratislava","team_a_country":"SVK","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/25576.png","team_b_id":"25571","team_b_name":"HC Dinamo Minsk","team_b_short_name":"Dinamo Minsk","team_b_tla_name":"DIN","team_b_original_name":"HC Dinamo Minsk","team_b_country":"BLR","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/25571.png","status":"Played","gameweek":"","winner":"team_A","score_a":"3","score_b":"2","p1s_a":"1","p1s_b":"2","p2s_a":"1","p2s_b":"0","p3s_a":"1","p3s_b":"0","ot_a":"","ot_b":"","so_a":"","so_b":"","venue_type":"home_away","final_period":"ice_p3s","attendance":"5932","venue_id":"9180","venue_name":"Zimný štadión Ondreja Nepelu","venue_city":"Bratislava","competition_id":"975","competition_name":"KHL","season_id":"17941","round_id":"23640","last_updated":"2019-02-13 23:58:22"},{"match_id":"1421334","date":"2019-02-15","time":"18:30:00","date_utc":"2019-02-15","time_utc":"17:30:00","team_a_id":"25572","team_a_name":"Dinamo Riga","team_a_short_name":"Dinamo Riga","team_a_tla_name":"RIG","team_a_original_name":"Dinamo Riga","team_a_country":"LVA","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/25572.png","team_b_id":"25571","team_b_name":"HC Dinamo Minsk","team_b_short_name":"Dinamo Minsk","team_b_tla_name":"DIN","team_b_original_name":"HC Dinamo Minsk","team_b_country":"BLR","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/25571.png","status":"Played","gameweek":"","winner":"team_A","score_a":"3","score_b":"1","p1s_a":"1","p1s_b":"0","p2s_a":"1","p2s_b":"1","p3s_a":"1","p3s_b":"0","ot_a":"","ot_b":"","so_a":"","so_b":"","venue_type":"home_away","final_period":"ice_p3s","attendance":"9500","venue_id":"9178","venue_name":"Arēna Rīga","venue_city":"Rīga","competition_id":"975","competition_name":"KHL","season_id":"17941","round_id":"23640","last_updated":"2019-02-15 23:58:21"},{"match_id":"1421341","date":"2019-02-17","time":"15:00:00","date_utc":"2019-02-17","time_utc":"14:00:00","team_a_id":"25571","team_a_name":"HC Dinamo Minsk","team_a_short_name":"Dinamo Minsk","team_a_tla_name":"DIN","team_a_original_name":"HC Dinamo Minsk","team_a_country":"BLR","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/25571.png","team_b_id":"25580","team_b_name":"HC Sochi","team_b_short_name":"HC Sochi","team_b_tla_name":"SOC","team_b_original_name":"HC Sochi","team_b_country":"RUS","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/25580.png","status":"Played","gameweek":"","winner":"team_B","score_a":"1","score_b":"3","p1s_a":"0","p1s_b":"0","p2s_a":"0","p2s_b":"2","p3s_a":"1","p3s_b":"1","ot_a":"","ot_b":"","so_a":"","so_b":"","venue_type":"home_away","final_period":"ice_p3s","attendance":"11341","venue_id":"9177","venue_name":"Minsk-Arena","venue_city":"Minsk","competition_id":"975","competition_name":"KHL","season_id":"17941","round_id":"23640","last_updated":"2019-02-17 22:58:07"},{"match_id":"1421358","date":"2019-02-20","time":"17:30:00","date_utc":"2019-02-20","time_utc":"16:30:00","team_a_id":"25584","team_a_name":"Vityaz Podolsk","team_a_short_name":"Vityaz Podolsk","team_a_tla_name":"VIT","team_a_original_name":"Vityaz Podolsk","team_a_country":"RUS","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/25584.png","team_b_id":"25571","team_b_name":"HC Dinamo Minsk","team_b_short_name":"Dinamo Minsk","team_b_tla_name":"DIN","team_b_original_name":"HC Dinamo Minsk","team_b_country":"BLR","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/25571.png","status":"Played","gameweek":"","winner":"team_A","score_a":"4","score_b":"3","p1s_a":"2","p1s_b":"1","p2s_a":"1","p2s_b":"0","p3s_a":"1","p3s_b":"2","ot_a":"","ot_b":"","so_a":"","so_b":"","venue_type":"home_away","final_period":"ice_p3s","attendance":"4500","venue_id":"9188","venue_name":"Vityaz Ice Palace","venue_city":"Podolsk","competition_id":"975","competition_name":"KHL","season_id":"17941","round_id":"23640","last_updated":"2019-05-06 22:36:08"},{"match_id":"1421373","date":"2019-02-22","time":"17:30:00","date_utc":"2019-02-22","time_utc":"16:30:00","team_a_id":"25573","team_a_name":"Jokerit","team_a_short_name":"Jokerit","team_a_tla_name":"JOK","team_a_original_name":"Jokerit","team_a_country":"FIN","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/25573.png","team_b_id":"25571","team_b_name":"HC Dinamo Minsk","team_b_short_name":"Dinamo Minsk","team_b_tla_name":"DIN","team_b_original_name":"HC Dinamo Minsk","team_b_country":"BLR","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/25571.png","status":"Played","gameweek":"1","winner":"team_B","score_a":"3","score_b":"5","p1s_a":"1","p1s_b":"2","p2s_a":"2","p2s_b":"1","p3s_a":"0","p3s_b":"2","ot_a":"","ot_b":"","so_a":"","so_b":"","venue_type":"home_away","final_period":"ice_p3s","attendance":"10084","venue_id":"6640","venue_name":"Ed Bush Stadium","venue_city":"West Bay","competition_id":"975","competition_name":"KHL","season_id":"17941","round_id":"23640","last_updated":"2019-05-06 22:36:19"}]},"next_matches":[]}}}