# GET /v2/coverage

Group: Catalog

What the API covers, counted from our own data rather than written by hand. totals: how many leagues, seasons, teams, players, fixtures, venues, managers and referees carry a SportsAPI id (every one readable by that id; the figures only grow). bySport: each sport’s league directory — categories (countries, regions, tours, games) and the leagues in them, the series for motorsport and cycling — and up to ten headline competitions with their season count and first season; historyFrom is the oldest of those. history sums up how far back the headline competitions reach (the median in years, the oldest season). How much detail an old season holds varies: scores and tables reach further back than lineups and statistics. Totals are recounted hourly and the directories daily (updatedAt); right after a restart a sport can be missing until its directory is read, and before the first count the call answers 503 with Retry-After. Every plan.

## Response

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

## Request

cURL:

```bash
curl -H "Authorization: Bearer sk_live_…" \
    "https://api.sportsapi.app/v2/coverage"
```

TypeScript:

```ts
const { data, meta } = await client.sports.coverage();
```

Python:

```python
res = client.sports.coverage()
```

Go:

```go
res, err := client.Sports.Coverage(ctx)
```

CLI:

```bash
$ sportsapi sports coverage
```

## Example response

```json
{ "data": { "updatedAt": "2026-11-12T05:58:21.587Z", "sports": 24,
    "totals": { "leagues": 9662, "seasons": 12716, "teams": 87913, "players": 61558, "fixtures": 813410,
                "venues": 6206, "managers": 5036, "referees": 684 },
    "history": { "leagues": 186, "medianYears": 16, "oldestSeason": 1920 },
    "bySport": [ { "sport": "football", "kind": "fixtures", "categories": 273, "leagues": 7606, "historyFrom": 1930,
        "headline": [ { "id": 195828, "name": "Premier League", "seasons": 35, "firstSeason": 1992 }, … ] }, … ] } }
```

---

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