Stats API
Menu
Public preview View coverage
Endpoint guide

Discover competitions and seasons.

Competition resources are the entry point for league, cup, and tournament discovery. Their Stats API IDs remain stable when a source adapter changes.

Available operations

Method Path Purpose
GET /v1/football/competitions Paginated competition catalog.
GET /v1/football/competitions/{competition_id} One competition by stable ID.
GET /v1/football/competitions/{competition_id}/seasons Seasons belonging to a competition.

Collection filters

The collection accepts q for a case-insensitive name search plus page and limit for pagination. Limit defaults to 25 and is capped at 100.

Example
GET /v1/football/competitions?q=premier&page=1&limit=25

Stable IDs

Persist the public competition_id in your own records. Do not infer an ID from a name or slug, because competition branding can change while the underlying resource remains the same.