No Subscription to this function
GET /handball/get_head2head
Returns head-2-head statistics between 2 teams.
Request URL
https://dsg-api.com/clients/{client_name}/handball/get_head2head?id={match_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)
id
int Required
match id to return
lang
string
two-character language code, defaults to 'en'
Nodes
match
Details about matches between both teams
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
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.
stats
Head-2-Head statistics
draws
number of draws
losses
number of losses
matches
number of matches
scores_against
number of scores against
scores_for
number of scores
type
type of match (away, home, neutral or total)
wins
number of wins
team
team informations
team_area
area name of the particular team
team_id
unique identifier for a team
team_name
current team name
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_head2head?id={match_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_head2head?id={match_id}&client={client_name}&authkey={client_authkey}"
response = requests.get("https://dsg-api.com/clients/{client_name}/handball/get_head2head?id={match_id}&client={client_name}&authkey={client_authkey}", auth=("User", "Password"))
Response Example
200 Success
{"datasportsgroup":{"version":"2.0","sport":"handball","lang":"en","method":{"method_id":"250","name":"get_head2head"},"head2head":{"team":[{"team_id":"26504","team_name":"FRISCH AUF! Göppingen","team_area":"Germany","stats":[{"type":"home","matches":"3","wins":"1","draws":"0","losses":"2","score_for":"77","score_against":"84"},{"type":"away","matches":"3","wins":"1","draws":"0","losses":"2","score_for":"78","score_against":"93"},{"type":"neutral","matches":"0","wins":"0","draws":"0","losses":"0","score_for":"0","score_against":"0"},{"type":"total","matches":"6","wins":"2","draws":"0","losses":"4","score_for":"155","score_against":"177"}]},{"team_id":"26505","team_name":"Füchse Berlin","team_area":"Germany","stats":[{"type":"home","matches":"3","wins":"2","draws":"0","losses":"1","score_for":"93","score_against":"78"},{"type":"away","matches":"3","wins":"2","draws":"0","losses":"1","score_for":"84","score_against":"77"},{"type":"neutral","matches":"0","wins":"0","draws":"0","losses":"0","score_for":"0","score_against":"0"},{"type":"total","matches":"6","wins":"4","draws":"0","losses":"2","score_for":"177","score_against":"155"}]}]},"head2head_matches":{"match":[{"match_id":"1752928","date":"2020-03-26","time":"15:00:00","date_utc":"2020-03-26","time_utc":"14:00:00","team_a_id":"26505","team_a_name":"Füchse Berlin","team_a_short_name":"Füchse Berlin","team_a_tla_name":"BER","team_a_original_name":"Füchse Berlin","team_a_country":"DEU","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/26505.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":"29","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":"8797","venue_name":"Max-Schmeling-Halle","venue_city":"Berlin","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":"1388385","date":"2019-03-21","time":"19:00:00","date_utc":"2019-03-21","time_utc":"18:00:00","team_a_id":"26505","team_a_name":"Füchse Berlin","team_a_short_name":"Füchse Berlin","team_a_tla_name":"BER","team_a_original_name":"Füchse Berlin","team_a_country":"DEU","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/26505.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":"25","winner":"team_B","score_a":"29","score_b":"33","p1s_a":"15","p1s_b":"13","p2s_a":"14","p2s_b":"20","et_a":"","et_b":"","so7_a":"","so7_b":"","venue_type":"home_away","final_period":"hbl_p2s","attendance":"6424","venue_id":"8797","venue_name":"Max-Schmeling-Halle","venue_city":"Berlin","competition_id":"1491","competition_name":"DKB Handball Bundesliga","season_id":"17053","round_id":"22877","last_updated":"2019-08-05 12:00:06"},{"match_id":"1362313","date":"2018-08-23","time":"19:00:00","date_utc":"2018-08-23","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":"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":"Played","gameweek":"1","winner":"team_A","score_a":"21","score_b":"18","p1s_a":"11","p1s_b":"9","p2s_a":"10","p2s_b":"9","et_a":"","et_b":"","so7_a":"","so7_b":"","venue_type":"home_away","final_period":"hbl_p2s","attendance":"4100","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:05"},{"match_id":"1039346","date":"2018-04-15","time":"12:30:00","date_utc":"2018-04-15","time_utc":"10:30:00","team_a_id":"26505","team_a_name":"Füchse Berlin","team_a_short_name":"Füchse Berlin","team_a_tla_name":"BER","team_a_original_name":"Füchse Berlin","team_a_country":"DEU","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/26505.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":"28","winner":"team_A","score_a":"33","score_b":"19","p1s_a":"17","p1s_b":"6","p2s_a":"16","p2s_b":"13","et_a":"","et_b":"","so7_a":"","so7_b":"","venue_type":"home_away","final_period":"hbl_p2s","attendance":"","venue_id":"8797","venue_name":"Max-Schmeling-Halle","venue_city":"Berlin","competition_id":"1491","competition_name":"DKB Handball Bundesliga","season_id":"13830","round_id":"14943","last_updated":"2019-04-16 04:00:02"},{"match_id":"1039201","date":"2017-11-02","time":"19:00:00","date_utc":"2017-11-02","time_utc":"18: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":"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":"Played","gameweek":"2","winner":"team_B","score_a":"32","score_b":"38","p1s_a":"13","p1s_b":"18","p2s_a":"19","p2s_b":"20","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":"DKB Handball Bundesliga","season_id":"13830","round_id":"14943","last_updated":"2017-12-17 12:06:07"},{"match_id":"1038980","date":"2017-02-25","time":"20:15:00","date_utc":"2017-02-25","time_utc":"19:15: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":"Played","gameweek":"21","winner":"team_B","score_a":"24","score_b":"28","p1s_a":"11","p1s_b":"12","p2s_a":"13","p2s_b":"16","et_a":"","et_b":"","so7_a":"","so7_b":"","venue_type":"home_away","final_period":"hbl_p2s","attendance":"","venue_id":"","venue_name":"","venue_city":"","competition_id":"1491","competition_name":"DKB Handball Bundesliga","season_id":"13831","round_id":"14944","last_updated":"2017-12-17 12:06:07"},{"match_id":"1038940","date":"2016-12-21","time":"19:00:00","date_utc":"2016-12-21","time_utc":"18:00:00","team_a_id":"26505","team_a_name":"Füchse Berlin","team_a_short_name":"Füchse Berlin","team_a_tla_name":"BER","team_a_original_name":"Füchse Berlin","team_a_country":"DEU","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/26505.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":"17","winner":"team_A","score_a":"31","score_b":"26","p1s_a":"15","p1s_b":"13","p2s_a":"16","p2s_b":"13","et_a":"","et_b":"","so7_a":"","so7_b":"","venue_type":"home_away","final_period":"hbl_p2s","attendance":"","venue_id":"","venue_name":"","venue_city":"","competition_id":"1491","competition_name":"DKB Handball Bundesliga","season_id":"13831","round_id":"14944","last_updated":"2017-12-17 12:06:07"}]}}}