Fixtures

List upcoming fixtures

Returns upcoming/scheduled matches from a start date forward (defaults to today), optionally bounded by an end date. By default only unstarted statuses (scheduled, not started, pending, incomplete, or null) are returned. Includes league, season, team, score, xG, odds, and probabilities.

Plan: Available on the free plan.

get/fixtures/upcoming

Request

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

Query parameters

fromstring

Start date (YYYY-MM-DD) inclusive. Defaults to today. Errors 400 (invalid_from_date) if malformed.

tostring

End date (YYYY-MM-DD) inclusive. Optional; if set, errors 400 (invalid_to_date) when malformed.

league_idinteger

Filter to a single league. Triggers a per-league access check (403 if not permitted).

season_idinteger

Filter to a single season.

team_idinteger

Filter to matches where the team plays home or away.

statusstring

Filter by exact match status. When omitted, only unstarted-type statuses are returned.

pageinteger

Page number for pagination (minimum 1).

limitinteger

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