Jolpica F1 is an open source API for querying Formula 1 data, with backwards compatible endpoints for the soon to be deprecated Ergast API.
Jolpica F1 is maintained by a small group of volunteers. Our hosting costs are around $45 USD per month. If you want to support the project's ongoing development and improvements, please consider donating to our Kofi. Our fundraising goal is to be break-even by the start of the 2025 season.
The Ergast compatible API can be found here: http://api.jolpi.ca/ergast/f1/
Our documentation can be found here.
If you are migrating from the Ergast API, please check the known differences here.
Our database model is not yet finalised and is different to the one used by ergast, this scheme will allow better adaption to changing rulesets, reduce duplication of information, and allow storage of more F1 related data.
Check out our database docs here.
Many Enumerations are used in the database, the mappings of these values are defined in their respective model files. For example you can find the enumerations for the PointSystem table here
For information on contributing to this project please read the contributing guidelines. You can also find instructions to run the project locally in CONTRIBUTING.md.
Below is a list of some open source community projects that use the jolpica-f1 API. If you've created something you'd like to share feel free to open a pull request to add it to the list.
- FastF1 - Python package for accessing and analyzing Formula 1 results, schedules, timing data and telemetry.
- f1dataR- R package to access Formula 1 Data from the jolpica-f1 API.
- JolpicaKit - Swift wrapper for the jolpica-f1 API.
- FormulaOne Card - Home Assistant Card showing Formula One Data.
- tap-f1- A Singer tap for F1.
- Next F1 Race scriptable widget - Widget for scriptable to display the next F1 Race.
- FormulaVision - A Mobile F1 Dashboard built with Flutter.
- RaceTimeApp - An Android App showing latest F1 data, Built with Jetpack Compose.
