Skip to main content
The Stats API provides football data as JSON over HTTP. Use the endpoint reference pages to inspect supported query parameters, path parameters, response examples, and coverage notes.

​
Base URL

​
Authentication

Every endpoint except the health check requires an Authorization header with a Bearer token:

​
Health check

Verify that the API is reachable without authentication.

​
Resource groups

Competitions

List competitions, retrieve competition details, inspect seasons, fetch group labels, and query standings.

Teams

Browse teams, fetch team details, inspect squads, retrieve season stats, and list standings history.

Matches

Query fixtures and results, then drill into details, referees, stats, live stats, player stats, lineups, heatmaps, shotmaps, and timelines.

Players

Search players, retrieve profiles, fetch competition-season stats, and request season heatmaps.

Odds

Retrieve prematch, historical, in-play, and player-prop odds for supported matches and bookmakers.

​
Pagination

List endpoints return a data array and a meta object. Use page and per_page to paginate; limit is accepted as an alias on endpoints that expose it in the reference.

​
Filtering

Common filters include competition_id, season_id, team_id, date ranges, status, stage, and group. Check each endpoint page for exact parameter support.