Skip to main content
Most football endpoints are built around stable IDs and season filters.

​
IDs

Use discovery endpoints before storing IDs in your application:
  • GET /v1/football/countries
  • GET /v1/football/leagues
  • GET /v1/football/teams
League, team, fixture, venue, and player IDs returned by this API are NextSportsAPI public IDs. Treat them as stable identifiers. Names, logos, venue names, country metadata, and coverage fields can change over time.

​
Seasons

Football seasons use a four-digit year, for example 2026. For many competitions, the season value is the year the season starts. Always confirm supported seasons with:
or by checking the seasons array returned by:

​
Timezones

Fixture endpoints can accept a timezone query parameter. Use a valid timezone from:
Example:
Last modified on May 20, 2026