Skip to content

Livematches in play

Demo: Matchboard, opens in a new tab
Docs v2

Discovery

Ranking

GET

/v2/rankings/{type}

All plans

View as MarkdownTry in Playground →

Returns one ranking, leaders first. Each row gives the current and previous position, current and previous points, the highest position reached and the number of tournaments played.

team holds the ranked team or competitor; it is null on UEFA country rows, where league is the country’s top division and country the country itself. In UFC and FNC divisions the champion sits at position 0 (the fnc-* types, available since 2026-11-04, cover Fight Nation Championship’s seven men’s divisions: the champion plus ten). On the utr-men and utr-women tables (available since 2026-11-04), points holds the player’s actual Universal Tennis Rating (for example 16.45 for Sinner), and the table runs 500 players deep. Any column our data source does not track for a given ranking is null.

Parameters

type

pathrequired

which ranking to return — any type listed by /v2/rankings, such as atp, fifa-men, uefa-clubs, utr-men, ufc-lightweight

Response

meta
type, updatedAt (null, or the moment our data source last refreshed the table), count
errors
404 not_found — the ranking type does not exist

Any /v2 call can also come back with one of the common errors.

curl -H "Authorization: Bearer sk_live_…" \
    "https://api.datasportsapi.com/v2/rankings/{type}"
Example
{ "data": [ { "position": 1, "previousPosition": 1, "points": 10950, "previousPoints": 11000, "bestPosition": 1, "tournamentsPlayed": 19,
    "team": { "id": 123, "name": "Jannik Sinner", "slug": "sinner-jannik", "shortName": "J. Sinner", "code": "SIN", "image": "https://cdn.datasportsapi.com/v2/teams/123/logo" },
    "league": null, "country": { "code": "IT", "name": "Italy" } }, … ],
  "meta": { "type": "atp", "updatedAt": "2026-10-19T00:00:00.000Z", "count": 500 } }