Fixtures

List finished match results

Returns completed matches up to an end date (defaults to today), optionally from a start date. By default only finished-type statuses (or past matches with both scores set) are returned. Includes final score with winner, plus corners, cards, and xG stats.

Plan: Available on the free plan.

get/fixtures/results

Request

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

Query parameters

fromstring

Start date (YYYY-MM-DD) inclusive. Optional; errors 400 (invalid_from_date) if malformed.

tostring

End date (YYYY-MM-DD) inclusive. Defaults to today. Errors 400 (invalid_to_date) if 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, finished-type statuses (or past matches with scores) 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.