Matches

List matches

Plan: Available on the free plan.

get/matches

Request

  • Base URL: https://footballdata.io/api/v1
  • URL: https://footballdata.io/api/v1/matches
  • Auth: HTTP bearer

Query parameters

datestring

Filter to matches on this exact date (YYYY-MM-DD). Matched via DATE(match_date).

fromstring

Filter to matches on or after this date (YYYY-MM-DD).

tostring

Filter to matches on or before this date (YYYY-MM-DD).

league_idinteger

Filter by league id.

season_idinteger

Filter by season id.

team_idinteger

Filter to matches where this team played at home or away.

statusstring

Filter by match status (exact match, e.g. complete, incomplete).

langstring

Language code for localized fields. Non-letters stripped, lowercased.

pageinteger

Page number (1-based).

limitinteger

Results per page, clamped between 1 and 100.

Response

Successful response

successboolean
dataobject
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.