Ranking
GET
/
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
typepathrequired
which ranking to return — any type listed by /v2/rankings, such as atp, fifa-men, uefa-clubs, utr-men, ufc-lightweight
Response
- data
RankingRow[]- 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 } }