Subscription to this function is not available for your account. To upgrade and receive access to this contact sales@datasportsgroup.com
v2 GET /rugby/get_head2head
Returns head-2-head statistics between 2 teams.
Request URL
https://dsg-api.com/clients/{client_name}/rugby/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
competition
details about the competition
competition_id
unique identifier for a competition
competition_name
name of the competition
datasportsgroup
details about the API version, sport, language and generation timestamp
generated_utc
UTC timestamp when the API output was generated
lang
language of the API call
sport
sport value
version
version of the API
discipline
basic information about the discipline
discipline_id
unique identifier of the discipline
name
name of the discipline
type
type of discipline (contestant, contestant_team or team)
gender
details about the gender
age_group
defines the age group (senior,u23,u22,u21....)
value
gender type (male, female or mixed)
match
details about the match
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.
last_updated
When record was last updated. Format YYYY-MM-DD HH:MM:SS in CET timezone.
match_id
unique identifier of match
score_a
full-time score of team_a
score_b
full-time score of team_b
status
status of the game (Played, Playing, Fixture, Cancelled, Postponed, Suspended, Awarded, Break, Retired, Bye, No Contest, Disqualified, Tech Knockout, Knockout, Draw, Submission) + (Cricket-specific = No Result, Tea, Lunch, Dinner, between Innings, Stumps, rain delay, bad light, crowd trouble, pitch condition, start delay, drinks, super over, floodlight failure)
team_a_area_code
three-letter-acronym of the area where the home team origins
team_a_area_id
unique area_id for team_a
team_a_area_name
area name of home team origins county
team_a_id
unique team ID for team_a
team_a_logo
team logo URL
team_a_name
current name of team_a
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 team_a
team_b_area_code
three-letter-acronym of the area where the home team origins
team_b_area_id
unique area_id for team_b
team_b_area_name
area name of away team origins county
team_b_id
unique team ID for team_b
team_b_logo
team logo URL
team_b_name
current name of team_b
team_b_original_name
the real name at the particular season (so can differ to current name)
team_b_short_name
short name of team_b
team_b_tla_name
three-letter-acronym of team_b
time
start time (CET), format 'hh:mm:ss'.
time_utc
start time (UTC), format 'hh:mm:ss'
venue_type
determines if the match is on neutral ground or on home/away basis (home_away or neutral)
winner
determines the winner of match ('team_A','team_B','draw','yet unknown')
match_extra
extra informations about the match
attendance
amount of people that attended the particular match
gameweek
contains the gameweek a match belongs to.
method
details about the API function
method_id
unique ID of method
name
name of method
period
details about periods of the match
score_a
period score of team_a
score_b
period score of team_b
type
three-letter-acronym of the period
round
basic details about the updated round
round_id
unique identifier of round
round_name
name of the round
season
details about the updated season
season_id
unique identifier for season
season_name
name of the competition for this particular season (including sponsor names etc)
season_title
title of season
stats
head-2-head statistics
behinds_against
number of behinds against
behinds_for
number of behinds made
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
basic details about a H2H team
team_area
area name of the team
team_id
unique identifier of the team
team_name
current team name
venue
basic details about the venue
venue_area_id
unique identifier for an area
venue_area_name
name of the area
venue_city
city where the venue is based
venue_id
unique identifier of the venue
venue_name
current name of the venue
Response Headers
200
Success
401
Unauthorized
429
Too Many Requests
Code Samples
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://dsg-api.com/clients/{client_name}/rugby/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}/rugby/get_head2head?id={match_id}&client={client_name}&authkey={client_authkey}"
Imports System
Imports System.Net	
Imports System.IO
Imports System.Text

Public Module Module1
	Public Sub Main()
		Dim url As String = "https://dsg-api.com/clients/{client_name}/rugby/get_head2head?id={match_id}&client={client_name}&authkey={client_authkey}"
		Dim myReq As WebRequest = WebRequest.Create(url)
		myReq.Credentials = new System.Net.NetworkCredential("{User}", "{Password}")
		Dim wr As WebResponse = myReq.GetResponse()
		Dim receiveStream As Stream = wr.GetResponseStream()
		Dim reader As StreamReader = New StreamReader(receiveStream, Encoding.UTF8)
		Dim content As String = reader.ReadToEnd()
	End Sub
End Module
response = requests.get("https://dsg-api.com/clients/{client_name}/rugby/get_head2head?id={match_id}&client={client_name}&authkey={client_authkey}", auth=("User", "Password"))
Response Example
200 Success
{"datasportsgroup":{"version":"2.0","sport":"rugby","lang":"en","method":{"method_id":"244","name":"get_head2head "},"head2head":{"team":[{"team_id":"30747","team_name":"Montpellier Hérault Rugby","team_area":"France","stats":[{"type":"home","matches":"3","wins":"1","draws":"0","losses":"2","scores_for":"78","scores_against":"61"},{"type":"away","matches":"2","wins":"2","draws":"0","losses":"0","scores_for":"34","scores_against":"26"},{"type":"neutral","matches":"0","wins":"0","draws":"0","losses":"0","scores_for":"0","scores_against":"0"},{"type":"total","matches":"5","wins":"3","draws":"0","losses":"2","scores_for":"112","scores_against":"87"}]},{"team_id":"30743","team_name":"Castres Olympique","team_area":"France","stats":[{"type":"home","matches":"2","wins":"0","draws":"0","losses":"2","scores_for":"26","scores_against":"34","goals_for":"0","goals_against":"0","behinds_for":"0","behinds_against":"0"},{"type":"away","matches":"3","wins":"2","draws":"0","losses":"1","scores_for":"61","scores_against":"78","goals_for":"0","goals_against":"0","behinds_for":"0","behinds_against":"0"},{"type":"neutral","matches":"0","wins":"0","draws":"0","losses":"0","scores_for":"0","scores_against":"0","goals_for":"0","goals_against":"0","behinds_for":"0","behinds_against":"0"},{"type":"total","matches":"5","wins":"2","draws":"0","losses":"3","scores_for":"87","scores_against":"112","goals_for":"0","goals_against":"0","behinds_for":"0","behinds_against":"0"}]}]},"head2head_matches":{"match":[{"match_id":"1752654","date":"2020-06-06","time":"18:00:00","date_utc":"2020-06-06","time_utc":"16:00:00","team_a_id":"30747","team_a_name":"Montpellier Hérault Rugby","team_a_short_name":"Montpellier","team_a_tla_name":"MON","team_a_original_name":"Montpellier Hérault Rugby","team_a_country":"FRA","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/30747.png","team_b_id":"30743","team_b_name":"Castres Olympique","team_b_short_name":"Castres Olymp.","team_b_tla_name":"CAS","team_b_original_name":"Castres Olympique","team_b_country":"FRA","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/30743.png","status":"Fixture","gameweek":"26","winner":"yet unknown","score_a":"","score_b":"","p1s_a":"","p1s_b":"","p2s_a":"","p2s_b":"","et_a":"","et_b":"","venue_type":"home_away","final_period":"rug_p2s","attendance":"","venue_id":"1266","venue_name":"Altrad Stadium","venue_city":"Montpellier","competition_id":"1034","competition_name":"Top 14","season_id":"23527","round_id":"34821","last_updated":"2019-08-07 14:42:35"},{"match_id":"1752480","date":"2019-08-24","time":"18:00:00","date_utc":"2019-08-24","time_utc":"16:00:00","team_a_id":"30743","team_a_name":"Castres Olympique","team_a_short_name":"Castres Olymp.","team_a_tla_name":"CAS","team_a_original_name":"Castres Olympique","team_a_country":"FRA","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/30743.png","team_b_id":"30747","team_b_name":"Montpellier Hérault Rugby","team_b_short_name":"Montpellier","team_b_tla_name":"MON","team_b_original_name":"Montpellier Hérault Rugby","team_b_country":"FRA","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/30747.png","status":"Fixture","gameweek":"1","winner":"yet unknown","score_a":"","score_b":"","p1s_a":"","p1s_b":"","p2s_a":"","p2s_b":"","et_a":"","et_b":"","venue_type":"home_away","final_period":"rug_p2s","attendance":"","venue_id":"12557","venue_name":"Stade Pierre-Fabre","venue_city":"Castres","competition_id":"1034","competition_name":"Top 14","season_id":"23527","round_id":"34821","last_updated":"2019-08-07 14:42:35"},{"match_id":"1382197","date":"2019-05-04","time":"18:00:00","date_utc":"2019-05-04","time_utc":"16:00:00","team_a_id":"30743","team_a_name":"Castres Olympique","team_a_short_name":"Castres Olymp.","team_a_tla_name":"CAS","team_a_original_name":"Castres Olympique","team_a_country":"FRA","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/30743.png","team_b_id":"30747","team_b_name":"Montpellier Hérault Rugby","team_b_short_name":"Montpellier","team_b_tla_name":"MON","team_b_original_name":"Montpellier Hérault Rugby","team_b_country":"FRA","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/30747.png","status":"Played","gameweek":"24","winner":"team_B","score_a":"9","score_b":"12","p1s_a":"6","p1s_b":"7","p2s_a":"3","p2s_b":"5","et_a":"","et_b":"","venue_type":"home_away","final_period":"rug_p2s","attendance":"11613","venue_id":"12557","venue_name":"Stade Pierre-Fabre","venue_city":"Castres","competition_id":"1034","competition_name":"Top 14","season_id":"17159","round_id":"23204","last_updated":"2019-06-12 13:09:53"},{"match_id":"1382034","date":"2018-08-26","time":"17:05:00","date_utc":"2018-08-26","time_utc":"15:05:00","team_a_id":"30747","team_a_name":"Montpellier Hérault Rugby","team_a_short_name":"Montpellier","team_a_tla_name":"MON","team_a_original_name":"Montpellier Hérault Rugby","team_a_country":"FRA","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/30747.png","team_b_id":"30743","team_b_name":"Castres Olympique","team_b_short_name":"Castres Olymp.","team_b_tla_name":"CAS","team_b_original_name":"Castres Olympique","team_b_country":"FRA","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/30743.png","status":"Played","gameweek":"1","winner":"team_B","score_a":"20","score_b":"25","p1s_a":"13","p1s_b":"13","p2s_a":"7","p2s_b":"12","et_a":"","et_b":"","venue_type":"home_away","final_period":"rug_p2s","attendance":"11000","venue_id":"1266","venue_name":"Altrad Stadium","venue_city":"Montpellier","competition_id":"1034","competition_name":"Top 14","season_id":"17159","round_id":"23204","last_updated":"2019-06-11 15:13:24"},{"match_id":"1380087","date":"2018-06-02","time":"20:45:00","date_utc":"2018-06-02","time_utc":"18:45:00","team_a_id":"30747","team_a_name":"Montpellier Hérault Rugby","team_a_short_name":"Montpellier","team_a_tla_name":"MON","team_a_original_name":"Montpellier Hérault Rugby","team_a_country":"FRA","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/30747.png","team_b_id":"30743","team_b_name":"Castres Olympique","team_b_short_name":"Castres Olymp.","team_b_tla_name":"CAS","team_b_original_name":"Castres Olympique","team_b_country":"FRA","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/30743.png","status":"Played","gameweek":"","winner":"team_B","score_a":"13","score_b":"29","p1s_a":"6","p1s_b":"19","p2s_a":"7","p2s_b":"10","et_a":"","et_b":"","venue_type":"home_away","final_period":"rug_p2s","attendance":"78442","venue_id":"65","venue_name":"Stade de France","venue_city":"Paris","competition_id":"1034","competition_name":"Top 14","season_id":"17143","round_id":"23102","last_updated":"2018-07-11 19:33:33"},{"match_id":"1380052","date":"2018-03-24","time":"20:50:00","date_utc":"2018-03-24","time_utc":"19:50:00","team_a_id":"30747","team_a_name":"Montpellier Hérault Rugby","team_a_short_name":"Montpellier","team_a_tla_name":"MON","team_a_original_name":"Montpellier Hérault Rugby","team_a_country":"FRA","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/30747.png","team_b_id":"30743","team_b_name":"Castres Olympique","team_b_short_name":"Castres Olymp.","team_b_tla_name":"CAS","team_b_original_name":"Castres Olympique","team_b_country":"FRA","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/30743.png","status":"Played","gameweek":"22","winner":"team_A","score_a":"45","score_b":"7","p1s_a":"21","p1s_b":"0","p2s_a":"24","p2s_b":"7","et_a":"","et_b":"","venue_type":"home_away","final_period":"rug_p2s","attendance":"10000","venue_id":"1266","venue_name":"Altrad Stadium","venue_city":"Montpellier","competition_id":"1034","competition_name":"Top 14","season_id":"17143","round_id":"23098","last_updated":"2018-07-11 19:26:44"},{"match_id":"1379919","date":"2017-09-09","time":"20:45:00","date_utc":"2017-09-09","time_utc":"18:45:00","team_a_id":"30743","team_a_name":"Castres Olympique","team_a_short_name":"Castres Olymp.","team_a_tla_name":"CAS","team_a_original_name":"Castres Olympique","team_a_country":"FRA","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/30743.png","team_b_id":"30747","team_b_name":"Montpellier Hérault Rugby","team_b_short_name":"Montpellier","team_b_tla_name":"MON","team_b_original_name":"Montpellier Hérault Rugby","team_b_country":"FRA","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/30747.png","status":"Played","gameweek":"3","winner":"team_B","score_a":"17","score_b":"22","p1s_a":"11","p1s_b":"9","p2s_a":"6","p2s_b":"13","et_a":"","et_b":"","venue_type":"home_away","final_period":"rug_p2s","attendance":"12023","venue_id":"12557","venue_name":"Stade Pierre-Fabre","venue_city":"Castres","competition_id":"1034","competition_name":"Top 14","season_id":"17143","round_id":"23098","last_updated":"2018-07-11 19:26:44"}]}}}