# GET /v2/rankings

Group: Discovery

Every ranking DataSportsAPI provides: FIFA (men), World Rugby (men), UEFA coefficients (countries, clubs), ATP and WTA singles (official, live), UTR ratings and padel world rankings (men and women each). The divisions of the UFC and of Fight Nation Championship are included too.

Plans: Every plan, Free included.

Note: entry indicates what each row of a ranking represents: team (a club or national side), competitor (a player or fighter, delivered as a TeamRef of kind individual) or country. The list comes from our own catalogue, so no upstream request is made.

## Parameters

| Name | In | Required | Description |
| --- | --- | --- | --- |
| `sport` | query | no | sport slug; limits the list to rankings of that sport |

## Response

- `data`: `RankingTypeInfo[]`
- `meta`: count, and sport when a sport filter was applied
- Objects: RankingTypeInfo (https://datasportsapi.com/markdown/reference.md#rankingtypeinfo)

## Errors

- 400 bad_request — the sport is not recognised

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"
```

TypeScript:

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

Python:

```python
res = client.rankings.list()
```

Go:

```go
res, err := client.Rankings.List(ctx, &datasportsapi.RankingsListParams{})
```

CLI:

```bash
$ dsa rankings list
```

## Example response

```json
{ "data": [ { "type": "fifa-men", "name": "FIFA World Ranking (men)", "sport": "football", "gender": "male", "entry": "team" },
    { "type": "uefa-countries", "name": "UEFA country coefficients", "sport": "football", "gender": null, "entry": "country" }, …,
    { "type": "atp", "name": "ATP singles ranking", "sport": "tennis", "gender": "male", "entry": "competitor" }, … ],
  "meta": { "count": 30 } }
```

---

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