---
title: "List game schedule"
method: GET
path: "/api/events/schedule"
tags: ["Events"]
---

# List game schedule

`GET /api/events/schedule`

## Request

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

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.

## Query parameters

- `teamId` string
- `upcomingLimit` integer
- `pastLimit` integer
- `season` integer

## Response `200`

{ success, data }

## Changes

- **2026-11-18** `6de639c52609`: 3 info
  - added the new optional `query` request parameter `pastLimit`
  - added the new optional `query` request parameter `season`
  - added the new optional `query` request parameter `upcomingLimit`
- **2026-08-17** `6a5e2c1b8022`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/changes/api/events/schedule/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)
