Events

List game schedule

Changed on

Public schedule. Repeatable teamId query param. Used by the locker-room hero strip and the HQ Schedule tab. One teamId with no limits returns that team's full depth (every live/forthcoming game plus every final/past row, up to 150 rows). Multi-team requests default to two separate per-team budgets: an upcoming bucket (live/delayed first, then the next 5 forthcoming kickoffs) and a past bucket (5 slots filled by the most recent completed rows first; a live row older than 6h uses only a leftover slot), merged and deduped by row id under an overall ceiling that scales with team count and the budgets. Games that already happened never take an upcoming slot; rows stuck on a pre-game status past 6h with no live data are served as past games with status and scores untouched. Cancelled fixtures are dropped before selection so they cannot take a slot. Postponed fixtures stay. Game rows explicitly include endedAt: ISO 8601 UTC string | null (#1116). It records the first accepted sync observation of final, not an estimated or vendor-certified finish time. Non-final rows and unknown end times return null. Eligible first observations require a known kickoff not in the future and no more than 12 hours old; existing finals are not backfilled. The stored timestamp is immutable across later and concurrent syncs. A delayed observation can extend the window beyond actual finish. Selected vendor rows are overlaid from stored timestamps in one bounded lookup. A failed lookup preserves schedule progress and known fallback timestamps; unknown timestamps stay null. The first final response can remain null while background persistence completes, plus s-maxage=60 cache latency.

get/api/events/schedule

Request

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

Query parameters

teamIdstring

Repeatable. Fan out per followed/joined team.

upcomingLimitinteger

Optional per-team upcoming-bucket budget. A single teamId with neither limit set returns full depth (up to 150 rows) instead; when only one limit is set, the other defaults to 5. Out-of-range or non-integer values are a 400.

pastLimitinteger

Optional per-team past-bucket budget. A single teamId with neither limit set returns full depth (up to 150 rows) instead; when only one limit is set, the other defaults to 5. Out-of-range or non-integer values are a 400.

seasoninteger

Season start year (2026 = 2026-27). Defaults to the current hockey season; scopes the vendor season reads.

Response

{ success, data }

Changes

    • info

      added the new optional query request parameter pastLimit

    • info

      added the new optional query request parameter season

    • info

      added the new optional query request parameter upcomingLimit