FOOTBALL API
Sign inRequest a key
The collectionDocumentationMembershipStatusSupport
Sign inRequest a key
Documentation / Seasons

FOOTBALL SEASON API

Season
Complimentary key

A season of a competition: its dates, its clubs and how many matches it holds. Competitions played in groups return each group. On the complimentary key it reads this season's Premier League.

GET/v1/competitions/{competition}/seasons/{season}
TRY ITComplimentary
Kept in this browser for every docs page. No key yet? Get a free key
GET https://api.footballapi.org/v1/competitions/premier-league/seasons/2026
The answer appears below, with its status and time.
curl "https://api.footballapi.org/v1/competitions/premier-league/seasons/2026" \
  -H "X-API-Key: your key"

PARAMETERS

competitionrequiredstringA competition from /v1/competitions, such as premier-league. In the path.
seasonrequiredintegerThe first year of the season: 2026 for 2026/27. In the path.From 2015, or the competition's first season

RETURNS

competitionstringThe competition's name in the collection, such as premier-league
country_namestringThe country, or World or Europe for a tournament
competition_namestringThe competition as people write it
season_start_yearintegerThe first year of the season: 2026 for 2026/27
matchesintegerMatches counted
finishedintegerMatches played so far
first_matchstringThe day of the first match
last_matchstringThe day of the last match, played or to come

EXAMPLE ANSWER

200GET /v1/competitions/premier-league/seasons/2026, taken 21 Oct 2026
{
  "data": {
    "competition": "premier-league",
    "country_name": "England",
    "competition_name": "Premier League",
    "season_start_year": 2026,
    "matches": 380,
    "finished": 70,
    "first_match": "2026-08-21",
    "last_match": "2027-05-30"
  },
  "meta": {
    "competition": "premier-league",
    "season": "2026/27",
    "request_id": "req_50bb5d4d8548b96a"
  }
}

ERRORS

401unauthorizedNo key, or a key we do not know.
400bad_requestA parameter is missing or not in the right form; the message names it.
403upgrade_requiredAnything outside this season's Premier League, on the complimentary key.
404not_foundAn id or competition we do not have.
422unknown_parameterA parameter this endpoint does not take.
429quota_exceededThe day's 50 calls are used, on the complimentary key; they reset at 00:00 UTC.
PREVIOUSCountriesNEXTTable