Subscription to this function is not available for your account. To upgrade and receive access to this contact sales@datasportsgroup.com
v3 GET /triathlon/get_results
Returns the results of the specific round/discipline
Request URL
https://dsg-api.com/clients/{client_name}/triathlon/get_results?id={season_id}&type=season&client={client_name}&authkey={client_authkey}
API Threshold
  • 10k calls per hour (2.78 calls per second)
  • This threshold applies to ALL your calls you do across the API.
  • Your number of calls get reset every hour at :00
  • If the thresold is reached within the hour you will get a xml/json message accordingly (which is gone when the next hour starts, see previous point)
Parameters
authkey
string Required
client authentification key
client
string Required
unique client ID
discipline_id
int
unique identifier for a discipline
ftype
string
changes feed type from XML to json (ftype=json or ftype=json_array)
id
int Required
season or round id to return
lang
string
two-character language code, defaults to 'en'
type
string Required
type is either "season" or "round"
Nodes
competition❯
details about competition
area_id
unique identifier for an area
area_name
name of the area
competition_id
unique identifier for a competition
format
competition format (domestic_league, domestic_cup, domestic_league_cup, domestic_super_cup, international_cup, international_super_cup, playoff, tournament, race, unofficial)
gender
determines the gender of the competition (male or female)
last_updated
When record was last updated. Format YYYY-MM-DD HH:MM:SS in CET timezone.
name
name of the competition
type
determines if a competition is between club teams (club) or national teams (international)
contestant❯
triathlon results for the contestant
bib_number
bib number of the contestant for this round
bike_position
position for the bike section
bike_time
time for the bike section
common_name
common name of the person
first_name
first name of the person
last_name
last name of the person
nationality_area_code
three character area code
nationality_area_id
unique identifier for an area
nationality_area_name
area name of peoples nationality
people_id
unique identifier for person
position
position value
record
type of record for the contestant or team (SB,PB,WR,OR etc)
short_name
shortened name of the person
status
status for this round, mainly if qualified or not (qualied = Q for example)
swim_position
position for the swimming section
swim_time
time for the swimming section
t1_position
position for the T1 section
t1_time
time for the T1 section
t2_position
position for the T2 section
t2_time
time for the T2 section
time
total time for this round
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)
method❯
details about the API function
method_id
unique ID of method
name
name of method
round❯
details about the round
end_date
end date, format 'yyyy-mm-dd'
end_date_utc
end date in UTC timezone, format 'yyyy-mm-dd'
end_time
end time, format 'HH:mm:ss'
end_time_utc
end time in UTC timezone, format 'HH:mm:ss'
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'
start_date_utc
start date in UTC timezone, format 'yyyy-mm-dd'.
start_time
start time, format 'HH:mm:ss'
start_time_utc
start time in UTC timezone, format 'HH:mm:ss'
type
determines if the round contains a table or a cup structure (knock-out)
round_extra❯
extra round details
medal_round
indicates if medals are awarded in this round
status
status of the round (Scheduled,Live,Played,Postponed,Cancelled,Break)
season❯
details about the 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
team❯
result informations for the team (triathlon)
bib_number
bib number of the contestant for this round
bike_position
position for the bike section
bike_time
time for the bike section
position
position value
record
type of record for the contestant or team (SB,PB,WR,OR etc)
status
status for this round, mainly if qualified or not (qualied = Q for example)
swim_position
position for the swimming section
swim_time
time for the swimming section
t1_position
position for the T1 section
t1_time
time for the T1 section
t2_position
position for the T2 section
t2_time
time for the T2 section
team_area_code
three-letter acronym for the area of the team
team_area_id
unique identifier for an area
team_area_name
area name of the team
team_id
unique identifier of the team
team_name
current team name
team_short_name
short name of the team
time
total time for this round
tour❯
details about the tour
gender
gender of the tour
name
name of the particular tour
tour_id
unique tour identifier
tour_type
defines if the tournament is part of a tour or not. If not then value "non-tour"
tour_season❯
details about a tour season
logo
full path URL of logo for particular tour_season
name
name of the tour_season
title
title of the particular tour season
tour_season_id
unique identifier of a tour season
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}/triathlon/get_results?id={season_id}&type=season&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}/triathlon/get_results?id={season_id}&type=season&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}/triathlon/get_results?id={season_id}&type=season&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}/triathlon/get_results?id={season_id}&type=season&client={client_name}&authkey={client_authkey}", auth=("User", "Password"))
Response Example
200 Success