leagues

League fixtures

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

get/leagues/{id}/fixtures

Request

  • Base URL: https://api.5dollarfootballapi.com/v1
  • URL: https://api.5dollarfootballapi.com/v1/leagues/{id}/fixtures
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Path parameters

idinteger required

League id.

Query parameters

seasonstring

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_timeinteger

A [start_time, end_time) kickoff window — unix seconds, UTC, start inclusive, end exclusive, no span limit. Handy for slicing historical data.

end_timeinteger

A [start_time, end_time) kickoff window — unix seconds, UTC, start inclusive, end exclusive, no span limit. Handy for slicing historical data.

statusstring

all | scheduled | live | finished | unknown. Defaults to all.

includestring

Comma list of odds | events | stats — same as /v1/fixtures. Caps per_page at 50.

langstring

Localize team & league names (21 languages, English fallback).

orderstring

desc (default, newest kickoff first) or asc. For a stable full-history crawl, pin the window with start_time/end_time rather than relying on the order — the plan history floor moves as you page.

pageinteger

Pagination (per_page max 100; 50 with include). Fixtures are ordered by kickoff, newest first by default.

per_pageinteger

Pagination (per_page max 100; 50 with include). Fixtures are ordered by kickoff, newest first by default.

Response

Success

success1 required

Changes

No recorded changes to this operation across all 1 revision of this API.