# GET /v2/rankings/{type}

Group: Discovery

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.

Plans: Every plan, Free included.

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

| Name | In | Required | Description |
| --- | --- | --- | --- |
| `type` | path | yes | 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
- Objects: RankingRow (https://datasportsapi.com/markdown/reference.md#rankingrow)

## Errors

- 404 not_found — the ranking type does not exist

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/rankings/{type}"
```

TypeScript:

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

Python:

```python
res = client.rankings.get(type)
```

Go:

```go
res, err := client.Rankings.Get(ctx, type)
```

CLI:

```bash
$ dsa rankings get <type>
```

## Example response

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

---

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/discovery/rankings-get/ · All docs: https://datasportsapi.com/markdown/docs.md · Data reference: https://datasportsapi.com/markdown/reference.md
