Subscription to this function is not available for your account. To upgrade and receive access to this contact sales@datasportsgroup.com
v2 GET /athletics/get_results
Returns the results of the specific round/discipline
Request URL
https://dsg-api.com/clients/{client_name}/athletics/get_results?id={season_id}&type=season&client={client_name}&authkey={client_authkey}
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)
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 to filter out leagues or cups
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
athletics results for the contestant
attempt_1_length
length of the 1st attempt
attempt_1_wind
strength of the wind during 1st attempt
attempt_2_length
length of the 2nd attempt
attempt_2_wind
strength of the wind during 2nd attempt
attempt_3_length
length of the 3rd attempt
attempt_3_wind
strength of the wind during 3rd attempt
attempt_4_length
length of the 4th attempt
attempt_4_wind
strength of the wind during 4th attempt
attempt_5_length
length of the 5th attempt
attempt_5_wind
strength of the wind during 5th attempt
attempt_6_length
length of the 6th attempt
attempt_6_wind
strength of the wind during 6th attempt
attempt_fixed_10_length
outcome of the 10th attempt (- = skipped, o = succesful, x = failed)
attempt_fixed_11_length
outcome of the 11th attempt (- = skipped, o = succesful, x = failed)
attempt_fixed_12_length
outcome of the 12th attempt (- = skipped, o = succesful, x = failed)
attempt_fixed_1_length
outcome of the 1st attempt (- = skipped, o = succesful, x = failed)
attempt_fixed_2_length
outcome of the 2nd attempt (- = skipped, o = succesful, x = failed)
attempt_fixed_3_length
outcome of the 3rd attempt (- = skipped, o = succesful, x = failed)
attempt_fixed_4_length
outcome of the 4th attempt (- = skipped, o = succesful, x = failed)
attempt_fixed_5_length
outcome of the 5th attempt (- = skipped, o = succesful, x = failed)
attempt_fixed_6_length
outcome of the 6th attempt (- = skipped, o = succesful, x = failed)
attempt_fixed_7_length
outcome of the 7th attempt (- = skipped, o = succesful, x = failed)
attempt_fixed_8_length
outcome of the 8th attempt (- = skipped, o = succesful, x = failed)
attempt_fixed_9_length
outcome of the 9th attempt (- = skipped, o = succesful, x = failed)
bib_number
bib number of the contestant for this round
common_name
common name of the person
fail_start
number of failed starts
first_name
first name of the person
lane
number of the lane for the contestant/team
last_name
last name of the person
length
best length of the contestant
nationality_area_code
three character area code
nationality_area_id
unique identifier for an area
nationality_area_name
area name of peoples nationality
order
number of order in which the contestant competed in this round
order_final
number of order after the first cut of this round
order_last_attempt
number of order for the last attempt of the round
people_id
unique identifier for person
position
position value
reaction_time
total reaction time for this round (in seconds)
record
type of record for the contestant or team (SB,PB,WR,OR etc)
red_cards
value of the particular stat
short_name
shortened name of the person
split_time_1000m
split time at 1000m
split_time_10km
split time at 10km
split_time_1200m
split time at 1200m
split_time_15km
split time at 15km
split_time_2000m
split time at 2000m
split_time_20km
split time at 20km
split_time_25km
split time at 25km
split_time_3000m
split time at 3000m
split_time_30km
split time at 30km
split_time_35km
split time at 35km
split_time_4000m
split time at 4000m
split_time_400m
split time at 400m
split_time_40km
split time at 40km
split_time_45km
split time at 45km
split_time_5000m
split time at 5000m
split_time_5km
split time at 5km
split_time_6000m
split time at 6000m
split_time_7000m
split time at 7000m
split_time_8000m
split time at 8000m
split_time_800m
split time at 800m
split_time_9000m
split time at 9000m
split_time_half_marathon
split time at Half Marathon
status
status for this round, mainly if qualified or not (qualied = Q for example)
time
total time for this round
yellow_card
number of yellow cards received (mainly for sprints)
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 or team)
gender
details about the gender
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)
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 (athletics)
bib_number
bib number of the contestant for this round
lane
lane of the contestant
position
position value
record
type of record for the contestant or team (SB,PB,WR,OR etc)
split_time_400m
split time at 400m
status
status for this round, mainly if qualified or not (qualied = Q for example)
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
time of the contestant (either time or just Q )
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
title
title of the particular tour season
tour_season_id
unique identifier of a tour 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}/athletics/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}/athletics/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}/athletics/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}/athletics/get_results?id={season_id}&type=season&client={client_name}&authkey={client_authkey}", auth=("User", "Password"))
Response Example
200 Success