# GET /v2/fixtures/counts

Group: Fixtures

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.

Plans: Every plan, Free included.

Note: 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

| Name | In | Required | Description |
| --- | --- | --- | --- |
| `date` | query | no | 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 |
| `sport` | query | no | sport slug — breaks the date’s count down by category |

## Response

- `data`: `FixtureCounts`
- Objects: FixtureCounts (https://datasportsapi.com/markdown/reference.md#fixturecounts)

## Errors

- 400 bad_request — malformed date, unrecognised sport, or a date other than today with no sport given
- 403 history_not_in_plan — the requested date lies before your plan’s history window
- 503 upstream_unavailable — counts are temporarily unavailable

Plus the common errors (https://datasportsapi.com/markdown/docs.md#errors).

## Request

cURL:

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

TypeScript:

```ts
const { data, meta } = await client.fixtures.counts();
```

Python:

```python
res = client.fixtures.counts()
```

Go:

```go
res, err := client.Fixtures.Counts(ctx, &datasportsapi.FixturesCountsParams{})
```

CLI:

```bash
$ dsa fixtures counts
```

## Example response

```json
$ 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 }, … ] } }
```

---

Base URL: https://api.datasportsapi.com. Authenticate each /v2 call with the header `Authorization: Bearer <key>` (secret keys begin with `sk_live_`).
HTML: https://datasportsapi.com/docs/fixtures/counts/ · All docs: https://datasportsapi.com/markdown/docs.md · Data reference: https://datasportsapi.com/markdown/reference.md
