World rankings

Archive MCP world_rankings

The world ranking for a discipline, the latest or as it stood on a date: every ranked player from September 2026, and for earlier dates back to 2013 the week's top list (about 20 to 25 places; meta.full says which).

GET/v1/rankings

Try it

Your key

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

disciplinerequired

date

page

per_page

cursor

Answer

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

Parameters

disciplinetextrequired: MS, WS, MD, WD or XD. MSWSMDWDXD
datedate: The ranking in force on this day.
pagewhole number: Which page. Default 1.
per_pagewhole number: Results a page, up to 200. Default 50.
cursortext: Meta.next_cursor from the page before.

Returns

rank: Position in the list.
name: The entry: a player, or both players of a doubles pair.
players: The entry's players: id (null when not yet matched to a player), name and country.
points: Ranking points.