Leagues

Season

GET/v2/leagues/{id}/seasons/{seasonId}All plans

Season facts: totals so far (goals, home / away wins, draws, cards, …) and the newcomers — relegated from above, promoted from below.

Statistic keys are the source’s and vary by sport. hostCountries lists a tournament’s hosts as Country objects (World Cup 2026: CA, MX, US; EURO 2020: eleven, England EN, Scotland SX); empty for a league season. A season without facts returns 200 with empty statistics and lists; 404 only for an id that does not exist or a season of another league.

Parameters

pathrequired

our numeric id (positive integer)

seasonId

pathrequired

a season id from /v2/leagues/{id}/seasons

Response

data: SeasonInfo
meta: season
errors: 404 not_found — seasonId is not one of this league’s seasons (the message names the parameter; list them with /v2/leagues/{id}/seasons)

Every /v2 call can also answer the common errors.

Try it →

$ curl -H "Authorization: Bearer sk_live_…" \
    "https://api.sportsapi.app/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 } }