Fixture counts
GET
/
View as MarkdownTry in Playground →
Fixture totals for a UTC date without paging: given a sport, the date’s total and a row per category (country, region, tour) with fixture and league counts, for any date; with no sport, today’s total per sport. The liveCount field gives the number of matches currently in play.
Dates are UTC, as on /v2/fixtures. liveCount is filled for today only (null on other dates) and comes from our live index — identical to the figure on /v2/sports — rather than from the date’s list, so a match that began yesterday may be included. Categories are sorted by fixture count, largest first; there is no live count per category because the source does not track one. With sport, fixtureCount is the sum across categories; without sport, it is the sum across sports. For one sport these totals may diverge by a few percent, since the category list includes some matches spilling over from late on the previous day. Race sports (motorsport, cycling) have no categories on this endpoint — use /v2/races. Available on all plans.
Parameters
datequery
UTC date as YYYY-MM-DD, defaults to today; accepts 1990-01-01 to one year ahead. If sport is omitted, only today is allowed
sportquery
sport slug — breaks the date’s count down by category
Response
- data
FixtureCounts- errors
- 400
bad_request— malformed date, unrecognised sport, or a date other than today with no sport given403history_not_in_plan— the requested date lies before your plan’s history window503upstream_unavailable— counts are temporarily unavailable
Any /v2 call can also come back with one of the common errors.
Example
$ curl -H "Authorization: Bearer sk_live_…" "https://api.datasportsapi.com/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.datasportsapi.com/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.datasportsapi.com/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 }, … ] } }