Drivers and teams

This section covers how to retrieve driver and team data, enrich it with season-specific details, and use it to build driver profiles, constructor pages, and team rosters.

In this section

• Drivers - How to list all drivers, retrieve a driver by ID, enrich with country and team data, and access driver metadata (debut season, short name, etc.).

• Teams - How to retrieve constructor teams, access season-specific team details (chassis, engine, team colour), and get the full driver roster for a team.

Drivers and teams in session context

Driver and team data appears in two contexts in the API: standalone (via the Drivers and Teams endpoints) and in-session (via the lineups include on a fixture).

For building a driver profile page, use the Drivers endpoint directly:

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

For displaying the driver lineup during or after a session, use the lineups include on the fixture and enrich it with driver data:

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

Season-specific team details (chassis name, engine, team colour) are available via the seasonDetails include on a team. These change year to year and are separate from the base team entity.

Related

• Endpoints

• Entities - Driver

• Entities - Team

• Enrich your response

• Metadata and Per-Season Data Type Reference