League fixtures

GET /v1/leagues/{id}/fixtures

One league's fixtures and results — the bulk entry point for historical data and backtesting. Defaults to your plan's whole history window plus the upcoming schedule; narrow it with start_time/end_time (no 24h span cap here), or pass ?season where the league lists seasons. Supports the same include, status and lang options as /v1/fixtures.

Parameters

id	required	League id.
season	optional	A season as listed for the league on /v1/leagues/{id}, e.g. 2026 or 26/27 — shorthand for that season's kickoff window. Leagues that list no seasons take start_time/end_time instead.
start_time, end_time	optional	A [start_time, end_time) kickoff window — unix seconds, UTC, start inclusive, end exclusive, no span limit. Handy for slicing historical data.
status	optional	all \| scheduled \| live \| finished. Defaults to all.
include	optional	Comma list of odds \| events \| stats — same as /v1/fixtures. Caps per_page at 50.
lang	optional	Localize team & league names (21 languages, English fallback).
page, per_page	optional	Pagination (per_page max 100; 50 with include). Fixtures are ordered by kickoff, oldest first.

Example

GET /v1/leagues/{id}/fixtures

curl https://api.5dollarfootballapi.com/v1/leagues/{id}/fixtures
  -H "Authorization: Bearer fb_live_your_key"

{
  "success": 1,
  "data": [
    {
      "id": 197412300,
      "league": { "id": 39, "name": "Premier League" },
      "teams": { "home": { "id": 2618, "name": "Arsenal" }, "away": { "id": 2611, "name": "Chelsea" } },
      "kickoff_utc": "2026-08-15T16:30:00+00:00",
      "kickoff_ts": 1786811400,
      "status": "scheduled",
      "goals": { "home": null, "away": null },
      "corners": { "home": null, "away": null },
      "cards": { "home": { "yellow": null, "red": null }, "away": { "yellow": null, "red": null } }
    }
  ],
  "pagination": { "page": 1, "per_page": 50, "count": 1, "has_more": true }
}

Need a key? Create a free account — a working key is issued instantly, no card required.

← All documentation Pricing →