Leagues & Countries

List leagues for a country

Resolves a country by name/ISO/FIFA code and returns its active leagues with season summaries, optionally embedding full season lists.

Plan: Available on the free plan.

get/countries/{country}/leagues

Request

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

Path parameters

countrystring required

Country identifier to look up. Matched (case-insensitive) against country name, ISO code, or FIFA ISO3. Dashes are converted to spaces and the value is URL-decoded. Errors with missing_country (400) if absent; country_not_found (404) if unmatched.

Query parameters

include_seasonsboolean

When truthy (1/true/yes), embeds a per-league 'seasons' array (season_id, year, is_current) ordered year-descending.

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.