# GET /v2/leagues/{id}

Group: Leagues

A league’s profile: tier (level in the national pyramid), gender, reigning champion and its title count, clubs with the most titles, the divisions above and below, and when the current season starts and ends. The category field reflects how our data source groups leagues — by country, by region (e.g. International), by tour (e.g. ATP) or by esports title; country is populated only for categories that are countries.

Plans: Every plan, Free included.

## Parameters

| Name | In | Required | Description |
| --- | --- | --- | --- |
| `id` | path | yes | league id issued by DataSportsAPI, a positive integer |

## Response

- `data`: `LeagueDetail`
- Objects: LeagueDetail (https://datasportsapi.com/markdown/reference.md#leaguedetail)

## 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/leagues/{id}"
```

TypeScript:

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

Python:

```python
res = client.leagues.get(id)
```

Go:

```go
res, err := client.Leagues.Get(ctx, id)
```

CLI:

```bash
$ dsa leagues get <id>
```

## Example response

```json
{ "data": { "id": 195828, "name": "Premier League", "slug": "premier-league", "sport": "football",
    "category": "England", "country": { "code": "EN", "name": "England" },
    "image": "https://cdn.datasportsapi.com/v2/leagues/195828/logo",
    "tier": 1, "gender": "male",
    "titleHolder": { "id": 4500, "name": "Liverpool", "slug": "liverpool", "shortName": "Liverpool", "code": "LIV", "image": "…" },
    "titleHolderTitles": 20, "mostTitles": 20,
    "mostTitlesTeams": [ { "id": 4501, "name": "Manchester United", … }, { "id": 4500, "name": "Liverpool", … } ],
    "upperDivisions": [], "lowerDivisions": [ { "id": 195850, "name": "Championship", … } ],
    "currentSeasonStart": "2026-08-21", "currentSeasonEnd": "2027-05-23" } }
```

---

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