Team rankings

GET

https://api.datasportsapi.com/v2/teams/{id}/rankings

Plan: All plans
Auth: Bearer dsa_live_…
Parameters: 1 required · 0 optional
Returns: TeamRanking[]

Gives a team’s or competitor’s place in each ranking table DataSportsAPI serves: the ATP / WTA rankings and live rankings for tennis players (career high included) plus their UTR rating; the FIFA or World Rugby ranking for national teams; UEFA coefficients for clubs; the padel world ranking for padel players; and the UFC or Fight Nation Championship division for fighters.

Worth knowing

Each table contributes one row, ordered as in /v2/rankings, and that row is the team’s entry in /v2/rankings/{type}.
Rankings we do not serve are omitted.
Since 2026-11-04, a utr-men / utr-women row puts the player’s UTR rating (16.45) in points, along with the best position ever reached and its date (bestPositionAt).
If the team is in no table, the array is empty.
bestPosition holds the career high when the source supplies it (tennis), while bestPositionAt is seldom filled.

01Parameters

Name	In	Required	Description
`id`	path	Required	DataSportsAPI team id, a positive integer

idpathRequired
DataSportsAPI team id, a positive integer

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/teams/{id}/rankings"

03Response

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

data: TeamRanking[]
meta: count

ObjectsTeamRanking

Example response

8 lines

{ "data": [
    { "type": "atp", "position": 2, "previousPosition": 1, "points": 9450, "previousPoints": 10450, "bestPosition": 1,
      "bestPositionAt": null, "tournamentsPlayed": 19 },
    { "type": "atp-live", "position": 2, "previousPosition": 2, "points": 9450, "previousPoints": null, "bestPosition": null,
      "bestPositionAt": null, "tournamentsPlayed": null },
    { "type": "utr-men", "position": 1, "previousPosition": null, "points": 16.45, "previousPoints": 16.44, "bestPosition": 1,
      "bestPositionAt": "2025-07-22T11:15:55.000Z", "tournamentsPlayed": null } ],
  "meta": { "count": 3 } }

04Errors

Nothing specific to this endpoint: only the account-wide errors below apply.

Any key can also meet401unauthorized429rate_limited429quota_exceeded500internal_errorEvery error code