Fixtures

Fixture counts

GET/v2/fixtures/countsAll plans
View as MarkdownTry in Playground →

How many fixtures a UTC day has, without paging it: with sport, the day’s total and one row per category (country, region, tour) with its fixture and league counts — any day; without sport, every sport’s total for today. liveCount is the number in play now.

UTC days, like /v2/fixtures. liveCount (today only, else null) is our live index — the same figure as /v2/sports — not a count of the day’s list, so it can include a match that started yesterday. Categories come most fixtures first; the source keeps no per-category live count, so none is given. fixtureCount with sport adds up the categories; without sport it adds up the sports — the two can differ by a few percent for the same sport (the category list counts some matches carried over from late the previous day). The race sports (motorsport, cycling) have no categories here: use /v2/races. Every plan.

Parameters

date
query
a UTC day, YYYY-MM-DD (default today; 1990-01-01 up to a year ahead). Without sport only today
sport
query
a sport slug: count its day per category

Response

data
FixtureCounts
errors
400 bad_request — invalid date, unknown sport, or a day other than today without sport403 history_not_in_plan — the day is older than your plan’s history503 upstream_unavailable — the count could not be fetched right now

Every /v2 call can also answer the common errors.

ExampleTry it →
$ curl -H "Authorization: Bearer sk_live_…" "https://api.sportsapi.app/v2/fixtures/counts?sport=football"

{ "data": { "date": "2026-11-04", "sport": "football", "fixtureCount": 1216, "liveCount": 46, "sports": [],
    "categories": [ { "category": { "id": 3112, "name": "USA", "slug": "usa", "sport": "football",
                                    "country": { "code": "US", "name": "USA", "flag": "https://cdn.sportsapi.app/v2/countries/US/flag" } },
                      "fixtureCount": 121, "leagueCount": 6 },
                    { "category": { "id": 3405, "name": "Europe", "slug": "europe", "sport": "football", "country": null },
                      "fixtureCount": 37, "leagueCount": 4 }, … ] } }

$ curl -H "Authorization: Bearer sk_live_…" "https://api.sportsapi.app/v2/fixtures/counts"

{ "data": { "date": "2026-11-04", "sport": null, "fixtureCount": 3577, "liveCount": 151, "categories": [],
    "sports": [ { "sport": "football", "fixtureCount": 1171, "liveCount": 46 },
                { "sport": "table-tennis", "fixtureCount": 1013, "liveCount": 13 }, … ] } }