Subscription to this function is not available for your account. To upgrade and receive access to this contact sales@datasportsgroup.com
v2 GET /multisport/get_contestants
Returns a list of contestants
Request URL
https://dsg-api.com/clients/{client_name}/multisport/get_contestants?client={client_name}&authkey={client_authkey}&type=sport&type_id=athletics&id={multisport_event_season_id}
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
unique multi-sport event season ID
lang
string
two-character language code, defaults to 'en'
type
string Required
type is either "sport" , "discipline" or "area"
Nodes
contestant❯
details about the contestant
common_name
common name of the person
contestant_team_id
unique identifier for the contestant team/double
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
short_name
shortened name of the person
slug
widget slug to be used for athlete widget (multisport)
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)
membership❯
details about the membership
membership_id
unique identifier for the membership
team_id
unique identifier of the team
team_name
current team name
method❯
details about the API function
method_id
unique ID of method
name
name of method
multisport_event❯
basic informations about the multisport event
area_code
three character area code
area_id
unique identifier for an area
area_name
name of the area
gender
determines the gender of the competition (male or female)
multisport_event_id
unique identifier for multisport events
multisport_event_name
general name of the multisport events
multisport_event_season❯
basic informations about the multisport event season
end_date
end date, format 'yyyy-mm-dd'
multisport_event_season_id
unique identifier for multisport event season
multisport_event_season_name
general name of the multisport event season
start_date
start date, format 'yyyy-mm-dd'
sport❯
basic information of the sport
sport
sport value
sport_name
name of the sport
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}/multisport/get_contestants?client={client_name}&authkey={client_authkey}&type=sport&type_id=athletics&id={multisport_event_season_id}");
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}/multisport/get_contestants?client={client_name}&authkey={client_authkey}&type=sport&type_id=athletics&id={multisport_event_season_id}"
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}/multisport/get_contestants?client={client_name}&authkey={client_authkey}&type=sport&type_id=athletics&id={multisport_event_season_id}"
		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}/multisport/get_contestants?client={client_name}&authkey={client_authkey}&type=sport&type_id=athletics&id={multisport_event_season_id}", auth=("User", "Password"))
Response Example
200 Success