No Subscription to this function
GET /badminton/get_draw
Returns all participants of the tournament with draw and seeding positions
Request URL
https://dsg-api.com/clients/{client_name}/badminton/get_draw?id={season_id}&client={client_name}&authkey={client_authkey}
Parameters
authkey
string Required
client authentification key
client
string Required
unique client ID
ftype
string
changes feed type from XML to json (ftype=json)
id
int Required
player id to return
lang
string
two-character language code, defaults to 'en'
Nodes
contestant
details about the contestant
common_name
common name of the contestant
contestant_id
unique identifier for the contestant
contestant_nationality_area_id
unique identifier for an area
contestant_nationality_area_name
area name of peoples nationality
contestant_nationality_code
three-letter acronym of the nationality
currency
currency used by the tournament for the prize money
draw_position
darw position of the contestant
first_name
first name of the contestant
last_name
last name of the contestant
match_name
match name of the contestant (aka short name)
points
world ranking points earned at this tournament
prize_money
prize money earner at this tournament
seeding
seeding of the contestant
contestant_team
tournament related details for the contestant team
contestant_team_id
unique identifier for the contestant team/double
currency
currency used by the tournament for the prize money
draw_position
darw position of the contestant team
points
world ranking points earned at this tournament
prize_money
prize money earner at this tournament
seeding
seeding of the contestant
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
sport
sport of the API
version
version of the API
method
details about the API function
method_id
unique ID of method.
name
name of method.
tour
details about a 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"
tournament
details about a specific tournament
gender
defines if male or female playing the tournament, additionally mix is possible
season_id
unique identifier of an particular edition of the tournament
season_name
name of the tournament for this particular year (including sponsor names etc)
season_title
title of the season including gender and type (single,double,mix)
single_double
defines if this is Singles, Doubles or Mix tournament
surface
surface the tournament will be played on (Hard, Clay, Grass)
tournament_id
unique identifier for a tournament
tournament_name
general name of the tournament (without sponsor names etc)
type
type of tournament at the particular tour
winner
unique identifier of the contestant who won the tournament
winner_name
name of the contestant who won the tournament
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}/badminton/get_draw?id={season_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}/badminton/get_draw?id={season_id}&client={client_name}&authkey={client_authkey}"
response = requests.get("https://dsg-api.com/clients/{client_name}/badminton/get_draw?id={season_id}&client={client_name}&authkey={client_authkey}", auth=("User", "Password"))
Response Example
200 Success
{"datasportsgroup":{"version":"1.0","sport":"badminton","lang":"en","method":{"method_id":"259","name":"get_draw"},"tour":{"tour_id":"8","name":"BWF World Tour","gender":"male","tour_season":{"tour_season_id":"22","title":"2019","tournament":{"tournament_id":"2039","tournament_name":"Thailand Open","season_id":"20223","season_title":"2019 Mens Singles","season_name":"Thailand Open","gender":"male","type":"Super 500","single_double":"Singles","winner":"","winner_name":"","contestant":[{"contestant_id":"3171463","first_name":"Kento","last_name":"Momota","common_name":"Kento Momota","nationality":"102","seeding":"1","draw_position":"1","prize_money":"","currency":"","points":""},{"contestant_id":"3188047","first_name":"Subhankar","last_name":"Dey","common_name":"Subhankar Dey","nationality":"94","seeding":"","draw_position":"2","prize_money":"","currency":"","points":""},{"contestant_id":"3186543","first_name":"Kantaphon","last_name":"Wangcharoen","common_name":"Kantaphon Wangcharoen","nationality":"191","seeding":"","draw_position":"3","prize_money":"","currency":"","points":""},{"contestant_id":"3186540","first_name":"Sai Praneeth","last_name":"Bhamidipati","common_name":"Sai Praneeth B.","nationality":"94","seeding":"","draw_position":"4","prize_money":"","currency":"","points":""},{"contestant_id":"3171442","first_name":"Kanta","last_name":"Tsuneyama","common_name":"Kanta Tsuneyama","nationality":"102","seeding":"7","draw_position":"5","prize_money":"","currency":"","points":""},{"contestant_id":"3186470","first_name":"Sourabh","last_name":"Verma","common_name":"Sourabh Verma","nationality":"94","seeding":"","draw_position":"6","prize_money":"","currency":"","points":""},{"contestant_id":"3187943","first_name":"Sitthikom","last_name":"Thammasin","common_name":"Sitthikom Thammasin","nationality":"191","seeding":"","draw_position":"7","prize_money":"","currency":"","points":""},{"contestant_id":"3186538","first_name":"Mark","last_name":"Caljouw","common_name":"Mark Caljouw","nationality":"138","seeding":"","draw_position":"8","prize_money":"","currency":"","points":""},{"contestant_id":"3186549","first_name":"Long","last_name":"Chen","common_name":"Chen Long","nationality":"49","seeding":"4","draw_position":"9","prize_money":"","currency":"","points":""},{"contestant_id":"3171449","first_name":"Tzu Wei","last_name":"Wang","common_name":"Wang Tzu Wei","nationality":"50","seeding":"","draw_position":"10","prize_money":"","currency":"","points":""},{"contestant_id":"3186548","first_name":"Ka Long Angus","last_name":"Ng","common_name":"Ng Ka Long Angus","nationality":"91","seeding":"","draw_position":"11","prize_money":"","currency":"","points":""},{"contestant_id":"3171448","first_name":"Daren","last_name":"Liew","common_name":"Daren Liew","nationality":"123","seeding":"","draw_position":"12","prize_money":"","currency":"","points":""},{"contestant_id":"3186544","first_name":"Srikanth","last_name":"Kidambi","common_name":"Kidambi Srikanth","nationality":"94","seeding":"5","draw_position":"13","prize_money":"","currency":"","points":""},{"contestant_id":"3199941","first_name":"Pengbo","last_name":"Ren","common_name":"Ren Pengbo","nationality":"49","seeding":"","draw_position":"14","prize_money":"","currency":"","points":""},{"contestant_id":"3186547","first_name":"Khosit","last_name":"Phetpradab","common_name":"Khosit Phetpradab","nationality":"191","seeding":"","draw_position":"15","prize_money":"","currency":"","points":""},{"contestant_id":"3171444","first_name":"Cheuk Yiu","last_name":"Lee","common_name":"Lee Cheuk Yiu","nationality":"91","seeding":"","draw_position":"16","prize_money":"","currency":"","points":""},{"contestant_id":"3186541","first_name":"Prannoy Haseena Sunil","last_name":"Kumar","common_name":"H. S. Prannoy","nationality":"94","seeding":"","draw_position":"17","prize_money":"","currency":"","points":""},{"contestant_id":"3186545","first_name":"Wing Ki Vincent","last_name":"Wong","common_name":"Wong Wing Ki Vincent","nationality":"91","seeding":"","draw_position":"18","prize_money":"","currency":"","points":""},{"contestant_id":"3188046","first_name":"Sony Dwi","last_name":"Kuncoro","common_name":"Sony Dwi Kuncoro","nationality":"95","seeding":"","draw_position":"19","prize_money":"","currency":"","points":""},{"contestant_id":"3171459","first_name":"Kenta","last_name":"Nishimoto","common_name":"Kenta Nishimoto","nationality":"102","seeding":"6","draw_position":"20","prize_money":"","currency":"","points":""},{"contestant_id":"3188043","first_name":"Kashyap","last_name":"Parupalli","common_name":"Parupalli Kashyap","nationality":"94","seeding":"","draw_position":"21","prize_money":"","currency":"","points":""},{"contestant_id":"3171454","first_name":"Brice","last_name":"Leverdez","common_name":"Brice Leverdez","nationality":"76","seeding":"","draw_position":"22","prize_money":"","currency":"","points":""},{"contestant_id":"3186458","first_name":"Misha","last_name":"Zilberman","common_name":"Misha Zilberman","nationality":"99","seeding":"","draw_position":"22","prize_money":"","currency":"","points":""},{"contestant_id":"3171445","first_name":"Dong Keun","last_name":"Lee","common_name":"Lee Dong Keun","nationality":"107","seeding":"","draw_position":"23","prize_money":"","currency":"","points":""},{"contestant_id":"3171456","first_name":"Tien Chen","last_name":"Chou","common_name":"Chou Tien Chen","nationality":"50","seeding":"3","draw_position":"24","prize_money":"","currency":"","points":""},{"contestant_id":"3171446","first_name":"Tommy","last_name":"Sugiarto","common_name":"Tommy Sugiarto","nationality":"95","seeding":"","draw_position":"25","prize_money":"","currency":"","points":""},{"contestant_id":"3170321","first_name":"Junpeng","last_name":"Zhao","common_name":"Zhao Junpeng","nationality":"49","seeding":"","draw_position":"26","prize_money":"","currency":"","points":""},{"contestant_id":"3186459","first_name":"Zii Jia","last_name":"Lee","common_name":"Lee Zii Jia","nationality":"123","seeding":"","draw_position":"27","prize_money":"","currency":"","points":""},{"contestant_id":"3171461","first_name":"Sameer","last_name":"Verma","common_name":"Sameer Verma","nationality":"94","seeding":"8","draw_position":"28","prize_money":"","currency":"","points":""},{"contestant_id":"3171457","first_name":"Dan","last_name":"Lin","common_name":"Lin Dan","nationality":"49","seeding":"","draw_position":"29","prize_money":"","currency":"","points":""},{"contestant_id":"3186550","first_name":"Suppanyu","last_name":"Avihingsanon","common_name":"Suppanyu Avihingsanon","nationality":"191","seeding":"","draw_position":"30","prize_money":"","currency":"","points":""},{"contestant_id":"3188102","first_name":"Lucas","last_name":"Claerbout","common_name":"Lucas Claerbout","nationality":"76","seeding":"","draw_position":"31","prize_money":"","currency":"","points":""},{"contestant_id":"3186546","first_name":"Yuqi","last_name":"Shi","common_name":"Shi Yuqi","nationality":"49","seeding":"2","draw_position":"32","prize_money":"","currency":"","points":""},{"contestant_id":"3187941","first_name":"Shesar Hiren","last_name":"Rhustavito","common_name":"Shesar Hiren Rhustavito","nationality":"95","seeding":"","draw_position":"32","prize_money":"","currency":"","points":""}]}}}}}