# GET /v2/teams/{id}/rankings

Group: Teams

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.

Plans: Every plan, Free included.

Note: 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.

## Parameters

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

## Response

- `data`: `TeamRanking[]`
- `meta`: count
- Objects: TeamRanking (https://datasportsapi.com/markdown/reference.md#teamranking)

## Errors

Plus the common errors (https://datasportsapi.com/markdown/docs.md#errors).

## Request

cURL:

```bash
curl -H "Authorization: Bearer sk_live_…" \
    "https://api.datasportsapi.com/v2/teams/{id}/rankings"
```

TypeScript:

```ts
const { data, meta } = await client.teams.rankings(id);
```

Python:

```python
res = client.teams.rankings(id)
```

Go:

```go
res, err := client.Teams.Rankings(ctx, id)
```

CLI:

```bash
$ dsa teams rankings <id>
```

## Example response

```json
{ "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 } }
```

---

Base URL: https://api.datasportsapi.com. Authenticate each /v2 call with the header `Authorization: Bearer <key>` (secret keys begin with `sk_live_`).
HTML: https://datasportsapi.com/docs/teams/rankings/ · All docs: https://datasportsapi.com/markdown/docs.md · Data reference: https://datasportsapi.com/markdown/reference.md
