Seasons

List teams in a season

Returns a paginated list of teams that competed in a given season, with table position, performance rank, risk, season context, and venue. Supports filtering by country and a name search.

Plan: Available on the free plan.

get/seasons/{season_id}/teams

Request

  • Base URL: https://footballdata.io/api/v1
  • URL: https://footballdata.io/api/v1/seasons/{season_id}/teams
  • Auth: HTTP bearer

Path parameters

season_idinteger required

Season ID whose teams to list. Must be > 0 or the endpoint returns missing_season_id (400). Caller must have access to the season's league.

Query parameters

countrystring

Filter teams by exact country.

searchstring

Case-insensitive partial match against team name fields (team_name, clean, english, full_name, short_name).

pageinteger

Page number, minimum 1.

limitinteger

Results per page, clamped between 1 and 100.

Response

Successful response

successboolean
metaMeta

Request metadata: usage counters, plan access, and pagination when applicable.

Example response

{
  "success": true
}

Changes

No recorded changes to this operation across all 1 revision of this API.