Leagues & Countries

League season stats overview (Paid)

Returns aggregate statistics for a league's most recent season (goals, results split, BTTS, clean sheets, over/under 2.5, corner/card/foul/attack/xG averages, home advantage, attendance).

Plan: Requires a paid plan (Starter, Pro, or Enterprise).

get/leagues/{league_id}/stats

Request

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

Path parameters

league_idinteger required

League ID to fetch stats for. Must be > 0 or the endpoint returns missing_league_id (400). Caller must have league access.

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.