No Subscription to this function
GET /kabaddi/get_head2head
Returns head-2-head statistics between 2 teams.
Request URL
https://dsg-api.com/clients/{client_name}/kabaddi/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
behinds_a
number of behinds scored by home team
behinds_b
number of behinds scored by away team
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.
goals_a
number of goals scored by home team
goals_b
number of goals scored by away team
last_updated
when record was last updated. Format YYYY-MM-DD HH:MM:SS in CET timezone.
match_id
unique identifier of match.
p1s_a
1st period score of home team.
p1s_b
1st period score of away team.
p2s_a
2nd period score of home team
p2s_b
2nd period score of away team
p3s_a
3rd period score of home team.
p3s_b
3rd period score of away team.
p4s_a
4th period score of home team
p4s_b
4th 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 away 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
behinds_against
number of behinds against
behinds_for
number of behinds
draws
number of draws
goals_against
number of goals against
goals_for
number of goals
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}/kabaddi/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}/kabaddi/get_head2head?id={match_id}&client={client_name}&authkey={client_authkey}"
response = requests.get("https://dsg-api.com/clients/{client_name}/kabaddi/get_head2head?id={match_id}&client={client_name}&authkey={client_authkey}", auth=("User", "Password"))
Response Example
200 Success
{"datasportsgroup":{"version":"2.0","sport":"kabaddi","lang":"en","method":{"method_id":"253","name":"get_head2head"},"head2head":{"team":[{"team_id":"31330","team_name":"Tamil Thalaivas","team_area":"India","stats":[{"type":"home","matches":"4","wins":"2","draws":"1","losses":"1","score_for":"140","score_against":"122"},{"type":"away","matches":"3","wins":"0","draws":"0","losses":"3","score_for":"90","score_against":"121"},{"type":"neutral","matches":"0","wins":"0","draws":"0","losses":"0","score_for":"0","score_against":"0"},{"type":"total","matches":"7","wins":"2","draws":"1","losses":"4","score_for":"230","score_against":"243"}]},{"team_id":"30827","team_name":"Patna Pirates","team_area":"India","stats":[{"type":"home","matches":"3","wins":"3","draws":"0","losses":"0","score_for":"121","score_against":"90"},{"type":"away","matches":"4","wins":"1","draws":"1","losses":"2","score_for":"122","score_against":"140"},{"type":"neutral","matches":"0","wins":"0","draws":"0","losses":"0","score_for":"0","score_against":"0"},{"type":"total","matches":"7","wins":"4","draws":"1","losses":"2","score_for":"243","score_against":"230"}]}]},"head2head_matches":{"match":[{"match_id":"1661221","date":"2019-09-09","time":"17:00:00","date_utc":"2019-09-09","time_utc":"15:00:00","team_a_id":"31330","team_a_name":"Tamil Thalaivas","team_a_short_name":"Tamil Thalaiva","team_a_tla_name":"TAM","team_a_original_name":"Tamil Thalaivas","team_a_country":"IND","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/31330.png","team_b_id":"30827","team_b_name":"Patna Pirates","team_b_short_name":"Patna Pirates","team_b_tla_name":"PTP","team_b_original_name":"Patna Pirates","team_b_country":"IND","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/30827.png","status":"Fixture","gameweek":"8","winner":"yet unknown","score_a":"","score_b":"","p1s_a":"","p1s_b":"","p2s_a":"","p2s_b":"","ets_a":"","ets_b":"","venue_type":"home_away","final_period":"kab_p2s","attendance":"","venue_id":"8612","venue_name":"Netaji Subhash Chandra Bose Indoor Stadium","venue_city":"Kolkata, West Bengal","competition_id":"1259","competition_name":"VIVO Pro Kabaddi League","season_id":"22192","round_id":"33139","last_updated":"2019-07-16 07:29:49"},{"match_id":"1661154","date":"2019-07-29","time":"16:00:00","date_utc":"2019-07-29","time_utc":"14:00:00","team_a_id":"31330","team_a_name":"Tamil Thalaivas","team_a_short_name":"Tamil Thalaiva","team_a_tla_name":"TAM","team_a_original_name":"Tamil Thalaivas","team_a_country":"IND","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/31330.png","team_b_id":"30827","team_b_name":"Patna Pirates","team_b_short_name":"Patna Pirates","team_b_tla_name":"PTP","team_b_original_name":"Patna Pirates","team_b_country":"IND","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/30827.png","status":"Played","gameweek":"2","winner":"team_B","score_a":"23","score_b":"24","p1s_a":"23","p1s_b":"24","p2s_a":"23","p2s_b":"24","ets_a":"","ets_b":"","venue_type":"home_away","final_period":"kab_p2s","attendance":"","venue_id":"8422","venue_name":"DOME@NSCI SVP Stadium","venue_city":"Mumbai, Maharashtra","competition_id":"1259","competition_name":"VIVO Pro Kabaddi League","season_id":"22192","round_id":"33139","last_updated":"2019-07-29 17:07:32"},{"match_id":"1428753","date":"2018-11-30","time":"16:30:00","date_utc":"2018-11-30","time_utc":"15:30:00","team_a_id":"31330","team_a_name":"Tamil Thalaivas","team_a_short_name":"Tamil Thalaiva","team_a_tla_name":"TAM","team_a_original_name":"Tamil Thalaivas","team_a_country":"IND","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/31330.png","team_b_id":"30827","team_b_name":"Patna Pirates","team_b_short_name":"Patna Pirates","team_b_tla_name":"PTP","team_b_original_name":"Patna Pirates","team_b_country":"IND","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/30827.png","status":"Played","gameweek":"","winner":"draw","score_a":"35","score_b":"35","p1s_a":"35","p1s_b":"35","p2s_a":"35","p2s_b":"35","ets_a":"","ets_b":"","venue_type":"home_away","final_period":"kab_p2s","attendance":"","venue_id":"8615","venue_name":"Thyagaraj Sports Complex","venue_city":"New Delhi, Delhi","competition_id":"1259","competition_name":"Pro Kabaddi League","season_id":"18005","round_id":"23892","last_updated":"2018-12-17 17:07:36"},{"match_id":"1428738","date":"2018-11-21","time":"15:30:00","date_utc":"2018-11-21","time_utc":"14:30:00","team_a_id":"30827","team_a_name":"Patna Pirates","team_a_short_name":"Patna Pirates","team_a_tla_name":"PTP","team_a_original_name":"Patna Pirates","team_a_country":"IND","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/30827.png","team_b_id":"31330","team_b_name":"Tamil Thalaivas","team_b_short_name":"Tamil Thalaiva","team_b_tla_name":"TAM","team_b_original_name":"Tamil Thalaivas","team_b_country":"IND","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/31330.png","status":"Played","gameweek":"","winner":"team_A","score_a":"45","score_b":"27","p1s_a":"45","p1s_b":"27","p2s_a":"45","p2s_b":"27","ets_a":"","ets_b":"","venue_type":"home_away","final_period":"kab_p2s","attendance":"","venue_id":"8676","venue_name":"The Arena","venue_city":"Ahmedabad, Gujarat","competition_id":"1259","competition_name":"Pro Kabaddi League","season_id":"18005","round_id":"23892","last_updated":"2018-12-17 17:07:18"},{"match_id":"1428664","date":"2018-10-07","time":"16:30:00","date_utc":"2018-10-07","time_utc":"14:30:00","team_a_id":"31330","team_a_name":"Tamil Thalaivas","team_a_short_name":"Tamil Thalaiva","team_a_tla_name":"TAM","team_a_original_name":"Tamil Thalaivas","team_a_country":"IND","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/31330.png","team_b_id":"30827","team_b_name":"Patna Pirates","team_b_short_name":"Patna Pirates","team_b_tla_name":"PTP","team_b_original_name":"Patna Pirates","team_b_country":"IND","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/30827.png","status":"Played","gameweek":"","winner":"team_A","score_a":"42","score_b":"26","p1s_a":"42","p1s_b":"25","p2s_a":"42","p2s_b":"26","ets_a":"","ets_b":"","venue_type":"home_away","final_period":"kab_p2s","attendance":"","venue_id":"11711","venue_name":"Jawaharlal Nehru Indoor Stadium","venue_city":"Chennai, Tamil Nadu","competition_id":"1259","competition_name":"Pro Kabaddi League","season_id":"18005","round_id":"23892","last_updated":"2018-12-17 17:07:17"},{"match_id":"969920","date":"2017-10-14","time":"16:30:00","date_utc":"2017-10-14","time_utc":"14:30:00","team_a_id":"31330","team_a_name":"Tamil Thalaivas","team_a_short_name":"Tamil Thalaiva","team_a_tla_name":"TAM","team_a_original_name":"Tamil Thalaivas","team_a_country":"IND","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/31330.png","team_b_id":"30827","team_b_name":"Patna Pirates","team_b_short_name":"Patna Pirates","team_b_tla_name":"PTP","team_b_original_name":"Patna Pirates","team_b_country":"IND","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/30827.png","status":"Played","gameweek":"","winner":"team_A","score_a":"40","score_b":"37","p1s_a":"40","p1s_b":"36","p2s_a":"40","p2s_b":"37","ets_a":"","ets_b":"","venue_type":"home_away","final_period":"kab_p2s","attendance":"","venue_id":"8614","venue_name":"Shree Shiv Chhatrapati Sports Complex","venue_city":"Puṇe","competition_id":"1259","competition_name":"Vivo Pro Kabaddi","season_id":"13286","round_id":"13528","last_updated":"2017-12-15 18:07:25"},{"match_id":"969882","date":"2017-09-20","time":"17:30:00","date_utc":"2017-09-20","time_utc":"15:30:00","team_a_id":"30827","team_a_name":"Patna Pirates","team_a_short_name":"Patna Pirates","team_a_tla_name":"PTP","team_a_original_name":"Patna Pirates","team_a_country":"IND","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/30827.png","team_b_id":"31330","team_b_name":"Tamil Thalaivas","team_b_short_name":"Tamil Thalaiva","team_b_tla_name":"TAM","team_b_original_name":"Tamil Thalaivas","team_b_country":"IND","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/31330.png","status":"Played","gameweek":"","winner":"team_A","score_a":"41","score_b":"39","p1s_a":"41","p1s_b":"38","p2s_a":"41","p2s_b":"39","ets_a":"","ets_b":"","venue_type":"home_away","final_period":"kab_p2s","attendance":"","venue_id":"11719","venue_name":"Harivansh Tana Bhagat Indoor Stadium","venue_city":"Ranchi, Jharkhand","competition_id":"1259","competition_name":"Vivo Pro Kabaddi","season_id":"13286","round_id":"13528","last_updated":"2017-12-15 18:07:25"},{"match_id":"969843","date":"2017-08-26","time":"16:30:00","date_utc":"2017-08-26","time_utc":"14:30:00","team_a_id":"30827","team_a_name":"Patna Pirates","team_a_short_name":"Patna Pirates","team_a_tla_name":"PTP","team_a_original_name":"Patna Pirates","team_a_country":"IND","team_a_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/30827.png","team_b_id":"31330","team_b_name":"Tamil Thalaivas","team_b_short_name":"Tamil Thalaiva","team_b_tla_name":"TAM","team_b_original_name":"Tamil Thalaivas","team_b_country":"IND","team_b_logo":"https:\/\/www.dsg-images.com\/clubs\/200x200\/31330.png","status":"Played","gameweek":"","winner":"team_A","score_a":"35","score_b":"24","p1s_a":"35","p1s_b":"24","p2s_a":"35","p2s_b":"24","ets_a":"","ets_b":"","venue_type":"home_away","final_period":"kab_p2s","attendance":"","venue_id":"8422","venue_name":"DOME@NSCI SVP Stadium","venue_city":"Mumbai, Maharashtra","competition_id":"1259","competition_name":"Vivo Pro Kabaddi","season_id":"13286","round_id":"13528","last_updated":"2017-12-15 18:07:25"}]}}}