# GET /v2/rankings/{type}

Group: Discovery

One ranking table, best first: position and previous position, points and previous points, best position, tournaments played.

Note: team is the ranked team or competitor (null on UEFA country rows, whose league is the country’s top league and country the country). UFC divisions list the champion at position 0. Columns the source does not keep for a ranking are null.

## Parameters

| Name | In | Required | Description |
| --- | --- | --- | --- |
| `type` | path | yes | a type from /v2/rankings, e.g. atp, fifa-men, uefa-clubs, ufc-lightweight |

## Response

- `data`: `RankingRow[]`
- `meta`: type, updatedAt (when the source last updated the table, or null), count
- Objects: RankingRow (https://sportsapi.app/markdown/en/reference.md#rankingrow)

## Errors

- 404 not_found — unknown ranking type

Plus the common errors (https://sportsapi.app/markdown/en/docs.md#errors).

## Request

cURL:

```bash
curl -H "Authorization: Bearer sk_live_…" \
    "https://api.sportsapi.app/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
$ sportsapi 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.sportsapi.app/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.sportsapi.app. Send your API key as `Authorization: Bearer <key>` on every /v2 request; keys are created in the dashboard (https://sportsapi.app/dashboard).
HTML: https://sportsapi.app/docs/discovery/rankings-get · All docs: https://sportsapi.app/markdown/en/docs.md