# GET /v2/leagues/{id}

Group: Leagues

League profile: level in its country’s pyramid (tier), gender, the title holder and how often it won, the record title holders, the divisions above and below, and the current season’s first and last day. category is the source’s grouping (a country, a region such as International, a tour such as ATP, an esports game); country is set only when the category is a country.

## Parameters

| Name | In | Required | Description |
| --- | --- | --- | --- |
| `id` | path | yes | our numeric id (positive integer) |

## Response

- `data`: `LeagueDetail`
- Objects: LeagueDetail (https://sportsapi.app/markdown/en/reference.md#leaguedetail)

## Request

cURL:

```bash
curl -H "Authorization: Bearer sk_live_…" \
    "https://api.sportsapi.app/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
$ sportsapi 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.sportsapi.app/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.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/leagues/get · All docs: https://sportsapi.app/markdown/en/docs.md