Subscription to this function is not available for your account. To upgrade and receive access to this contact sales@datasportsgroup.com
GET /boxing/get_matches
Returns all matches (and related events) that belong to a season, round or match
Request URL
https://dsg-api.com/clients/{client_name}/boxing/get_matches?type={type}&id={id}&client={client_name}&authkey={client_authkey}
Parameters
authkey
string Required
client authentification key
client
string Required
unique client ID
enddate
string
end date, format 'yyyy-mm-dd' (requires startdate to take effect)
ftype
string
changes feed type from XML to json (ftype=json)
id
int Required
object id to return
lang
string
two-character language code, defaults to 'en'
picsize
string
one of 200x200, 100x100, 50x50, 30x30 or 18x18 to get correct size of club logo.
startdate
string
start date, format 'yyyy-mm-dd' (requires enddate to take effect)
type
string Required
one of ‘season’, ‘round’ or ‘match’ to which the "id" refers
Nodes
competition
Details about competition
area_id
unique identifier for area.
area_name
contains the area name.
competition_id
unique identifier for a competition.
format
competition format to filter out leagues or cups
last_updated
When record was last updated. Format YYYY-MM-DD HH:MM:SS in CET timezone.
name
name of the competition.
teamtype
determines the type of team/competition (male,female,male_youth,female_youth)
type
determines if a competition is between club teams (club) or national teams (international).
contestant_a
details about the contestant
alias
nickname/alias of the boxer
common_name
common name of the person
first_name
first name of the person
height
Height of person in centimeters
last_name
last name of the person
match_name
shortened match name of the person
nationality_area_id
unique identifier for an area
nationality_area_name
area name of peoples nationality
nationality_code
three-letter acronym of the nationality
people_id
unique identifier for person
people_picture
full path URL of people headshot, size can be changed via the picsize parameter
place_of_birth
name of city the person was born
reach
reach of the boxer
stance
stance of the boxer
weight
Weight of person in kilograms.
contestant_b
details about the contestant
alias
nickname/alias of the boxer
common_name
common name of the person
first_name
first name of the person
height
Height of person in centimeters
last_name
last name of the person
match_name
shortened match name of the person
nationality_area_id
unique identifier for an area
nationality_area_name
area name of peoples nationality
nationality_code
three-letter acronym of the nationality
people_id
unique identifier for person
people_picture
full path URL of people headshot, size can be changed via the picsize parameter
place_of_birth
name of city the person was born
reach
reach of the boxer
stance
stance of the boxer
weight
Weight of person in kilograms.
croner
defines the corner of the boxer
value
defines if the boxer is in the red or blue corner
event
event details for knockdowns and penalties
clock
time on the clock when the event happened (aka how much time was left till the round ends)
common_name
common name of the contestant
count
defines until which number the referee counted the opponent fighter down
event_id
Unique identifier of a fight event
event_type
unique identifier for the type of event
first_name
first name of the contestant
last_name
last name of the driver
match_name
match name of the contestant (aka short name)
penalty_type
type of penalty received
people_id
unique identifier for person
points
number of points deducted due to the penalty received
fight_round
judge scores for the specific fight round
judge_1_a
scores of Judge 1 for contestant_a
judge_1_b
scores of Judge 1 for contestant_b
judge_2_a
scores of Judge 2 for contestant_a
judge_2_b
scores of Judge 2 for contestant_b
judge_3_a
scores of Judge 3 for contestant_a
judge_3_b
scores of Judge 3 for contestant_b
judge_dsg_a
scores of our DSG Expert for contestant_a
judge_dsg_b
scores of our DSG Expert for contestant_b
round
defines the fight round
fight_rounds
judge totals for all fight rounds
judge_1_a
scores of Judge 1 for contestant_a
judge_1_b
scores of Judge 1 for contestant_b
judge_2_a
scores of Judge 2 for contestant_a
judge_2_b
scores of Judge 2 for contestant_b
judge_3_a
scores of Judge 3 for contestant_a
judge_3_b
scores of Judge 3 for contestant_b
judge_dsg_a
scores of our DSG Expert for contestant_a
judge_dsg_b
scores of our DSG Expert for contestant_b
match
Details about match
clock
pending time on the clock during live fights
current_round
current round during a live fight
date
Date of match, format 'yyyy-mm-dd' (CET)
date_utc
Date of match, format 'yyyy-mm-dd' (UTC)
federation
federation for the fight, can be multiple ones comma seperated
fight_type
type of fight (title, contender, vacant_title, regular)
final_period
display the period in which the match finished. ('soc_p2s','soc_ets','soc_pen')
last_updated
when record was last updated. Format YYYY-MM-DD HH:MM:SS in CET timezone.
match_id
unique identifier of match.
max_rounds
max number of rounds for the fight
score_a
number of judges who saw fighter A as winner
score_b
number of judges who saw fighter B as winner
status
status of the game (Fixture,Playing,Played,Tech Knockout,Retired,Knockout,Disqualified,Draw)
time
start time (CET), format 'hh:mm:ss'.
time_per_round
time per round for the fight
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
weightclass
weightclass for the fight
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.
ranking
displays the rankings prior to the fight
association
boxing association
position
ranking within the boxing association
record
displays the fight records of the fighter
draws
number of draws
knockout_loss
number of knockout losses
knockout_wins
number of knockout wins
loss
number of losses
wins
number of wins
referee
details about the referees/judges
common_name
common name of the driver
date_of_birth
birth date of the person
first_name
first name of the driver
last_name
last name of the driver
match_name
match name of the driver
nationality_area_id
unique identifier for area.
nationality_area_name
area name of peoples nationality
nationality_code
three-letter acronym of the nationality
people_id
unique identifier for person
type
type of referee
round
Details about round
current_gameweek
displays the gameweek of nearest match to today
end_date
end date, format 'yyyy-mm-dd'.
last_updated
When record was last updated. Format YYYY-MM-DD HH:MM:SS in CET timezone.
name
name of round
round_id
unique identifier of round.
start_date
start date, format 'yyyy-mm-dd'.
type
Determines if the round contains a table or a cup structure (knock-out).
season
Details about season
end_date
end date, format 'yyyy-mm-dd'.
last_updated
when record was last updated. Format YYYY-MM-DD HH:MM:SS in CET timezone.
logo
full path URL of logo for particular season
original_name
competition name during this season
season_id
unique identifier for season.
start_date
start date, format 'yyyy-mm-dd'.
title
title of season
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}/boxing/get_matches?type={type}&id={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}/boxing/get_matches?type={type}&id={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}/boxing/get_matches?type={type}&id={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}/boxing/get_matches?type={type}&id={id}&client={client_name}&authkey={client_authkey}", auth=("User", "Password"))
Response Example
200 Success