Skip to content

Livematches in play

Demo: Matchboard, opens in a new tab
Docs v2

Catalog

Coverage

GET

/v2/coverage

All plans

View as MarkdownTry in Playground →

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.

Response

Any /v2 call can also come back with one of the common errors.

curl -H "Authorization: Bearer sk_live_…" \
    "https://api.datasportsapi.com/v2/coverage"
Example
{ "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 }, … ] }, … ] } }