Fixtures

List today's fixtures

Returns all matches scheduled for today (server date) with league, season, team, score, xG, market odds, and win probabilities. Paginated and filterable.

Plan: Available on the free plan.

get/fixtures/today

Request

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

Query parameters

league_idinteger

Filter to a single league. Triggers a per-league access check (403 if the plan lacks access).

season_idinteger

Filter to a single season.

statusstring

Filter by exact match status string (e.g. 'complete', 'scheduled').

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.