Season calendar
GET
/
View as MarkdownTry in Playground →
Returns each UTC day of a league season on which fixtures are scheduled, together with the number of fixtures — handy for drawing a season calendar or linking straight to a matchday via /v2/fixtures?date=&league=. Available since 2026-11-04.
Days are sorted oldest first. The list is rebuilt every day, so a rescheduled fixture moves to its new date within a day.
Parameters
idpathrequired
league id issued by DataSportsAPI, a positive integer
seasonqueryrequired
season id, as listed by /v2/leagues/{id}/seasons
Response
- data
SeasonDay[]- meta
- season, count (number of days), fixtureCount (fixtures across all those days)
- errors
- 403
history_not_in_plan— your plan’s history window begins after this season ended404not_found— the season id does not belong to this league
Any /v2 call can also come back with one of the common errors.
curl -H "Authorization: Bearer sk_live_…" \
"https://api.datasportsapi.com/v2/leagues/{id}/calendar?season=…"Example
{ "data": [ { "date": "2026-08-21", "fixtureCount": 1 }, { "date": "2026-08-22", "fixtureCount": 5 }, … ], "meta": { "season": 200386, "count": 112, "fixtureCount": 380 } }