Matches

Bulk historical matches export (Enterprise)

Plan: Enterprise plan only.

get/matches/bulk

Request

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

Query parameters

league_idinteger

Filter by league id. At least one of league_id, season_id, or from is required.

season_idinteger

Filter by season id. At least one of league_id, season_id, or from is required.

fromstring

Start date filter (YYYY-MM-DD); matches on or after. At least one of league_id, season_id, or from is required.

tostring

End date filter (YYYY-MM-DD); matches on or before.

statusstring

Filter by match status (exact match).

sortstring

Sort direction by match_date/id. Allowed: asc, desc.

pageinteger

Page number (1-based).

limitinteger

Results per page, clamped between 1 and 5000.

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.