Leagues & Countries

List seasons for a league

Returns a paginated list of a league's seasons (with team/match counts and date ranges), gated by the key's league access.

Plan: Available on the free plan.

get/leagues/{league_id}/seasons

Request

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

Path parameters

league_idinteger required

League to list seasons for. Required; errors missing_league_id (400) if absent/invalid, league_not_found (404) if not accessible/active. Access is enforced via api_require_league_access.

Query parameters

currentboolean

When truthy (1/true/yes), returns only the current season (is_current = 1).

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.