Skip to content
datasportsAPI

FixturesFixture counts

Documentation

/

Type to filter the docs by title or path.

FixturesEndpoint 4 of 116

Fixture counts

GET

/v2/fixtures/counts

Plan
All plans
Auth
Bearer dsa_live_…
Parameters
0 required · 2 optional
Returns
FixtureCounts
Try in Playground

Fixture totals for a UTC date, without paging through the list. Given a sport, it returns the date’s total plus a row per category (country, region, tour) holding fixture and league counts, for any date; with no sport, it returns today’s total for each sport. liveCount gives the number of matches currently in play.

Worth knowing

  • 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.

01Parameters

  • datequeryOptional

    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

  • sportqueryOptional

    sport slug — breaks the date’s count down by category

02Request

The same call from the command line and each SDK. The SDK lines assume a client created with your key; left out, it is read from DATASPORTSAPI_API_KEY. Installing a client: SDKs & CLI.

curl -H "Authorization: Bearer dsa_live_…" \
    "https://api.datasportsapi.com/v2/fixtures/counts"

03Response

The top-level keys of the JSON body. Each object links to its full shape in the data reference.

data
FixtureCounts
ObjectsFixtureCounts
Example call and response
$ curl -H "Authorization: Bearer dsa_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 dsa_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 }, … ] } }

04Errors

  • 400bad_request

    malformed date, unrecognised sport, or a date other than today with no sport given

  • 403history_not_in_plan

    the requested date lies before your plan’s history window

  • 503upstream_unavailable

    counts are temporarily unavailable

Any key can also meet401unauthorized429rate_limited429quota_exceeded500internal_errorEvery error code