Stats API
Menu
Public preview View coverage
Endpoint guide

Query fixtures and results.

The match collection covers scheduled fixtures and completed full-time results from the currently enabled datasets.

Available operations

Method Path Purpose
GET /v1/football/matches Filter and paginate fixtures or results.
GET /v1/football/matches/{match_id} Retrieve one match by stable ID.

Filters

Parameter Format
competition_id Stable competition ID.
season_id Stable season ID.
team_id Matches where the team is home or away.
status scheduled, live, finished, postponed, canceled, or unknown.
date_from Inclusive YYYY-MM-DD UTC date.
date_to Inclusive YYYY-MM-DD UTC date.
page / limit Positive page; limit 1–100.
Example
GET /v1/football/matches?team_id=tm_example&date_from=2026-08-01&date_to=2026-08-31

Freshness boundary

OpenFootball is a community-maintained fixtures and results source, not a guaranteed live-score feed. The response exposes stored source-update information where available; live incidents remain outside the beta contract.