Data Reference

Warning

The data reference is still under construction and currently only provides limited information.

The data reference provides an overview of all the data that is available via FastF1.

Additional Information

• How to perform calculations accurately
• Time, Date and Timing - Explanation

Available Data

The following is a short overview over the available data with some references to functions and objects used to work with this data.

In most cases, the default workflow with FastF1 is to create a Session object using get_session(). You, will then access all data through the session object. One notable exception to this pattern is the wrapper for Ergast.

Overview over the available data

Topic	Data	References
Event Schedule	event names, countries, locations, dates, scheduled starting times,… (previous and current season including upcoming events)	Event Schedule get_event_schedule() get_event()
Results	driver names, team names, finishing and grid positions, points, finishing status,…	SessionResults, DriverResult
Timing Data	sector times, lap times, pit stops, tyre data and much more	laps Laps
Track Status	flags, safety car	track_status
Session Status	started, finished, finalized	session_status
Race Control Messages	investigations, penalties, restart announcements,…	race_control_messages
Telemetry	speed, rpm, gear, normalized track position, …	Telemetry get_car_data()
Track Markers	corner numbers, marshall sectors, marshall lights	get_circuit_info(), Circuit Information
Jolpica-F1 API	all endpoints that are provided by Jolpica-F1 (previously Ergast)	Jolpica-F1 API Interface

Compatibility and Availability

Timing data, session information, car telemetry and position data are available from 2018 onwards. (This data is usually available within 30-120 minutes after the end of a session.) It is also possible to obtain this data by recording the data live stream, using the live timing recorder that is built into FastF1. Usually this is not necessary but there have been server issues in the past which caused the data to be not available for download. Recording of the data live stream is therefore mostly a solution for redundancy.

Schedule information and session results are available for older seasons as well, going back as far as 1950 (limited to data that is available through Ergast).