Seasons

List matches in a season

Plan: Available on the free plan.

get/seasons/{season_id}/matches

Request

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

Path parameters

season_idinteger required

Season ID to list matches for. Errors with missing_season_id if absent or <= 0; season_not_found (404) if inactive.

Query parameters

league_idinteger

Optional league filter. Requires the key's plan to have access to this league (api_require_league_access).

team_idinteger

Optional filter; returns matches where the team is home or away.

statusstring

Optional exact match status filter (e.g. complete, incomplete, suspended).

datestring

Filter to a single date (YYYY-MM-DD). Invalid format returns invalid_date (400).

fromstring

Start of date range (YYYY-MM-DD, inclusive). Invalid format returns invalid_from_date (400).

tostring

End of date range (YYYY-MM-DD, inclusive). Invalid format returns invalid_to_date (400).

sortstring

Sort direction by match date. Allowed: asc, desc. Anything else falls back to asc.

pageinteger

Page number for pagination (min 1).

limitinteger

Results per page, clamped between 1 and 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.