# GET /v2/coverage

Group: Catalog

Coverage figures for the whole API in one call, open to every plan: entity totals, each sport’s league directory and how far back its headline competitions reach. The totals object counts how many teams, players, fixtures, leagues, seasons, venues, managers and referees have a DataSportsAPI id; each one can be fetched by that id, and the numbers never go down. The bySport list describes every sport’s directory — its categories (countries, tours, regions or games) with the leagues they hold, or the series for motorsport and cycling — together with up to ten headline competitions, each with its number of seasons and its first season; historyFrom is the earliest of those. The history object condenses the depth of all headline competitions into a median span in years and the oldest season. Old seasons are thinner than recent ones: results and tables usually go back further than lineups and statistics. updatedAt says when the figures were computed — totals every hour, directories once a day. A sport may be absent for a while after a restart, until its directory has been read again, and until the very first count is ready the endpoint answers 503 with Retry-After.

Plans: Every plan, Free included.

## Response

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

## 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/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
$ dsa 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.datasportsapi.com. Authenticate each /v2 call with the header `Authorization: Bearer <key>` (secret keys begin with `sk_live_`).
HTML: https://datasportsapi.com/docs/catalog/sports-coverage/ · All docs: https://datasportsapi.com/markdown/docs.md · Data reference: https://datasportsapi.com/markdown/reference.md
