# GET /v2/rankings

Group: Discovery

The rankings we serve: FIFA (men), UEFA country and club coefficients, World Rugby (men), ATP and WTA singles (official and live) and the UFC divisions.

Note: entry says what a row ranks: team (a national team or club), competitor (a player or fighter — a TeamRef, kind individual) or country. Our own catalogue: answered without a fetch.

## Parameters

| Name | In | Required | Description |
| --- | --- | --- | --- |
| `sport` | query | no | a sport slug: only that sport’s rankings |

## Response

- `data`: `RankingTypeInfo[]`
- `meta`: count, plus sport when filtered
- Objects: RankingTypeInfo (https://sportsapi.app/markdown/en/reference.md#rankingtypeinfo)

## Errors

- 400 bad_request — unknown sport

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

TypeScript:

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

Python:

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

Go:

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

CLI:

```bash
$ sportsapi 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": 19 } }
```

---

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-list · All docs: https://sportsapi.app/markdown/en/docs.md