Fixtures

In the Motorsport API, a fixture is a single session: a practice session, a qualifying session, a sprint race, or the main race. Multiple fixtures make up a race weekend (stage). This section covers how to retrieve fixtures, understand session types, and work with session metadata.

In this section

• Fixtures - How to query fixtures by ID, by season, by stage, and how to enrich them with results and lineups.

Session types

A fixture has a name field that indicates the session type (e.g. "Race", "Qualifying", "Practice 1"). The metadata include gives you additional session-level data including whether the session counts towards standings, whether it is a sprint race, and the total lap count.

To retrieve a single fixture with its session metadata:

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

To retrieve all fixtures for a season in one call:

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

Fixture state

Every fixture has a state_id that tells you whether the session is scheduled, live, or finished. Fetch the state as an include to get the human-readable label:

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

See the Entities - State page for the full list of state values.

Related

• Endpoints

• Entities - Fixture

• Schedule and calendar

• Enrich your response

• Retrieving results

• Metadata and Per-Season Data Type Reference