Events

Today's game counts across all leagues

Changed on

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.

get/api/events/today

Request

  • Base URL
    https://app.d-sports.org
  • Auth
    none required

Query parameters

tzstring required
Example:America/Toronto

IANA time zone that defines "today". Missing or unknown is a 400.

Response

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

successtrue required

Changes