All systems normalData updated just nowStatusChangelogSupport
badmintonapi

Player profile

Archive

One player, with matches and wins by discipline, their best world ranking, and their birth date, playing hand and height where known.

GET/v1/players/{id}

Try it

Kept in this browser and filled in on every page. A key made in your account lands here by itself.

Answer

Press Run to call the API with your key. The answer appears here.

Parameters

idpl_ id, in the pathrequired
Which one, by its id.

Returns

id
The id: pl_, tr_, mt_, ev_ or vn_, never changing.
name
The name as held.
slug
The name in a web address.
country
IOC country code, like DEN, or null.
gender
M or W, from the events played.
first_year
The first year held.
last_year
The latest year held.
matches
Draw matches played.
wins
Matches won.
by_discipline
The same figures split by MS, WS, MD, WD and XD.
career_high
The player's best world ranking: rank, discipline, date (YYYY-MM-DD, or YYYY-MM when only the month is known) and doubles partner, with the best in each other event in other_events; null when none is known.
number_one
Time at world number one since 1 October 2009, by discipline: weeks in all, reigns, first and last day (last is null while it goes on) and current; null for a player who never was.
born
The player's birth date, YYYY-MM-DD; null when not known.
hand
The hand the player plays with: left or right; null when not known.
height_cm
The player's height in centimetres; null when not known.
coach
The player's coach or coaches as their own page names them, comma separated; null when not known.