Leagues & Countries

List teams in a league/season

Returns a paginated list of teams in a league for a given/implied season, including per-season standing position and stadium details, gated by league access.

Plan: Available on the free plan.

get/leagues/{league_id}/teams

Request

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

Path parameters

league_idinteger required

League whose teams to list. Required; errors missing_league_id (400) if absent/invalid, league_not_found (404) if not accessible/active. Enforced via api_require_league_access.

Query parameters

season_idinteger

Restrict teams to a specific season by season id.

yearinteger

Restrict teams to a specific season by year (matches tls.season_year).

pageinteger

Page number (min 1) for pagination.

limitinteger

Results per page; clamped to the range 1-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.