Skip to content
datasportsAPI

DiscoveryRanking

Documentation

/

Type to filter the docs by title or path.

DiscoveryEndpoint 87 of 116

Ranking

GET

/v2/rankings/{type}

Plan
All plans
Auth
Bearer dsa_live_…
Parameters
1 required · 0 optional
Returns
RankingRow[]
Try 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.

Worth knowing

  • 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.

01Parameters

  • typepathRequired

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

02Request

The same call from the command line and each SDK. The SDK lines assume a client created with your key; left out, it is read from DATASPORTSAPI_API_KEY. Installing a client: SDKs & CLI.

curl -H "Authorization: Bearer dsa_live_…" \
    "https://api.datasportsapi.com/v2/rankings/{type}"

03Response

The top-level keys of the JSON body. Each object links to its full shape in the data reference.

data
RankingRow[]
meta
type, updatedAt (null, or the moment our data source last refreshed the table), count
ObjectsRankingRow
Example response
{ "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 } }

04Errors

  • 404not_found

    the ranking type does not exist

Any key can also meet401unauthorized429rate_limited429quota_exceeded500internal_errorEvery error code