Subscription to this function is not available for your account. To upgrade and receive access to this contact sales@datasportsgroup.com
v3 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}
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❯
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, 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 (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
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}/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 Example200 Success