Season
GET
/
View as MarkdownTry in Playground →
Key figures for a season — running totals such as goals, home and away wins, draws and cards — plus the teams new to the division, whether relegated into it from above or promoted from below.
The statistic keys come from our data source and differ between sports. hostCountries lists a tournament’s host nations as Country objects — CA, MX and US for the 2026 World Cup; eleven hosts for EURO 2020, with England as EN and Scotland as SX — and stays empty for a regular league season. A season with no figures still answers 200, with empty statistics and lists; only an unknown id, or a season from another league, gets 404.
Parameters
idpathrequired
league id issued by DataSportsAPI, a positive integer
seasonIdpathrequired
season id, as listed by /v2/leagues/{id}/seasons
Response
- data
SeasonInfo- meta
- season
- errors
- 404
not_found— seasonId does not belong to this league; the error message names the parameter, and /v2/leagues/{id}/seasons lists the valid ones
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}/seasons/{seasonId}"Example
{ "data": { "statistics": { "goals": 198, "homeTeamWins": 31, "awayTeamWins": 24, "draws": 15,
"yellowCards": 280, "redCards": 9, … },
"newcomersUpperDivision": [],
"newcomersLowerDivision": [ { "id": 4502, "name": "Leeds United", "code": "LEE", … }, … ],
"newcomersOther": [],
"hostCountries": [] },
"meta": { "season": 200386 } }