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

FOOTBALL CLUBS BY SEASON API

Season clubs
Complimentary key

Every club in a competition in one season, with its ground, its city and where the ground is. On the complimentary key it reads this season's Premier League.

GET/v1/competitions/{competition}/seasons/{season}/clubs
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/clubs
The answer appears below, with its status and time.
curl "https://api.footballapi.org/v1/competitions/premier-league/seasons/2026/clubs" \
  -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

club_idstringOur id for the club, cl_ and 9 characters, the same in every answer and for good
club_namestringThe club
ground_namestringThe ground
city_namestringThe city of the ground
matchesintegerMatches counted

EXAMPLE ANSWER

200GET /v1/competitions/premier-league/seasons/2026/clubs, taken 21 Oct 2026, first rows shown
{
  "data": [
    {
      "club_id": "cl_frt0n2e46",
      "club_name": "Coventry",
      "ground_name": "Coventry Building Society Arena",
      "city_name": "Coventry",
      "matches": 38
    },
    {
      "club_id": "cl_e0nqz3rc3",
      "club_name": "Sunderland",
      "ground_name": "Stadium of Light",
      "city_name": "Sunderland",
      "matches": 38
    }
  ],
  "meta": {
    "count": 20,
    "competition": "premier-league",
    "season": "2026/27",
    "request_id": "req_a60481b59b7ab409"
  }
}

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.
PREVIOUSPositionsNEXTSeason matches