Schedule and calendar

This section covers how the Motorsport API models a racing season, from the championship level down to individual sessions. Understanding this hierarchy is the foundation for any race calendar, fixture list, or results archive.

In this section

• Leagues and seasons - The championship structure, how to find the current season ID, and how to work with historical seasons.

• Schedule - How to retrieve the full race calendar for a season.

• Stages - The race weekend structure: practice sessions, qualifying, sprint sessions, and the race itself.

The data hierarchy

The API is structured as a tree from championship down to session:

League (championship)
  └── Season (calendar year)
        └── Stage (race weekend)
              └── Fixture (individual session: FP1, qualifying, race, etc.)

A League is the championship, for example the Formula 1 World Championship. A Season is a calendar year. A Stage is a race weekend, grouping all sessions at one circuit. A Fixture is a single session within that weekend.

When you want all fixtures for the 2025 season, query the season and include fixtures:

https://api.sportmonks.com/v3/motorsport/seasons/SEASON_ID
?api_token=YOUR_TOKEN
&include=fixtures

When you want all sessions for a specific race weekend, query by stage ID:

https://api.sportmonks.com/v3/motorsport/stages/STAGE_ID
?api_token=YOUR_TOKEN
&include=fixtures

Related

• Entities

• Endpoints

• Fixtures

• Metadata and Per-Season Data Type Reference