Coverage at a glance

Returns headline totals for everything we cover: how many competitions, seasons and finished matches there are, and how many seasons are complete. Handy for a status page or a quick sanity check.

curl "https://api.soccer-data.co/v1/coverage/summary" \
  -H "X-Api-Key: $SOCCER_DATA_KEY"

const res = await fetch("https://api.soccer-data.co/v1/coverage/summary", {
  headers: { "X-Api-Key": process.env.SOCCER_DATA_KEY },
});
const { data } = await res.json();

import os, requests

res = requests.get(
    "https://api.soccer-data.co/v1/coverage/summary",
    headers={"X-Api-Key": os.environ["SOCCER_DATA_KEY"]},
)
data = res.json()["data"]

$data = Http::withHeaders(['X-Api-Key' => env('SOCCER_DATA_KEY')])
    ->get('https://api.soccer-data.co/v1/coverage/summary')
    ->json('data');

{
    "data": {
        "leagues": 204,
        "seasons": 1107,
        "finished_events": 202269,
        "seasons_by_status": {
            "complete": 922,
            "in_progress": 152,
            "not_loaded": 33
        },
        "pct_complete": 83.3
    }
}

### GET /coverage/summary

Coverage at a glance

Returns headline totals for everything we cover: how many competitions, seasons and finished matches there are, and how many seasons are complete. Handy for a status page or a quick sanity check.
- For a breakdown by competition, use /coverage/leagues.

Response fields:
- `data.leagues` (integer): Number of competitions.
- `data.seasons` (integer): Number of seasons across all competitions.
- `data.finished_events` (integer): Number of finished matches.
- `data.seasons_by_status.complete` (integer): Seasons where every loaded match has been played.
- `data.seasons_by_status.in_progress` (integer): Seasons with matches still to come.
- `data.seasons_by_status.not_loaded` (integer): Seasons with no matches loaded.
- `data.pct_complete` (number): Complete seasons as a percentage of all seasons, to one decimal place.

Example: curl "https://api.soccer-data.co/v1/coverage/summary" -H "X-Api-Key: $SOCCER_DATA_KEY"