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
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
nationality
nationality of the contestant
points
world ranking points earned at this tournament
prize_money
prize money earner at this tournament
seeding
seeding of the contestant
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
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
Rate limit exceeded
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":""}]}}}}}