---
title: "Today's game counts across all leagues"
method: GET
path: "/api/events/today"
tags: ["Events"]
---

# Today's game counts across all leagues

`GET /api/events/today`

## Request

- Base URL: `https://app.d-sports.org`
- URL: `https://app.d-sports.org/api/events/today`
- Auth: none required

Public hero-card summary for the fan's local day (#1128, engage-native#1320). `tz` is a required IANA zone; the day is local midnight to the next local midnight in it (23 or 25 hours on DST days). Source is persisted GameEvent rows across every sport and league; demo fixtures excluded; a game counts only when its league resolves via homeTeam.leagueId ?? awayTeam.leagueId, as on GET /api/events/live. Buckets: `live` uses the /api/events/live rule exactly (status live and startTime within the last 6 hours), including a game that kicked off before local midnight and is still live; `later` is upcoming or delayed; `final` is final, plus a live row whose kickoff is older than 6 hours (the schedule files those under past games). Postponed, cancelled and suspended games are left out of every count. `total` = live + later + final. `nextStartAt` is the soonest startTime among `later` games (ISO 8601 UTC) or null. Cache: same CDN policy as /api/events/live (s-maxage=30, stale-while-revalidate=60, stale-if-error=300), keyed by URL so each zone caches separately.

## Query parameters

- `tz` string, required

## Response `200`

{ success: true, data: { total, live, later, final, nextStartAt } }

- object
  - `success` true, required
  - `data` object, required
    - `total` integer, required
    - `live` integer, required
    - `later` integer, required
    - `final` integer, required
    - `nextStartAt` string, date-time, nullable, required

## Other responses

- `400`: Missing or unknown IANA zone (VALIDATION_ERROR).
- `502`: Read failed (UPSTREAM_ERROR, retriable).

## Changes

- **2026-11-18** `6de639c52609`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/changes/api/events/today/get.md)

---

[API](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api.md) - [All operations](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/llms.txt) - [OpenAPI document](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/revisions/63735cf90a04?raw)
