Leagues & Countries

Get league standings table

Returns the full standings table for a league season (defaulting to the latest season when none is specified), with home/away splits and zone info, gated by league access.

Plan: Available on the free plan.

get/leagues/{league_id}/standings

Request

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

Path parameters

league_idinteger required

League whose standings table to return. 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

Standings for a specific season id. If neither season_id nor year is given, the latest available season is used automatically.

yearinteger

Standings for a specific season year (used only when season_id is not provided). If neither is given, the latest season is chosen.

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.