Skip to main content
Version: V2

What's Changed

Migration of Endpoints (Races, Qualifying & Practices)​

In V1, the endpoints returned both event metadata and results in a single response:

  • GET /races/:raceId
  • GET /practices/:practiceId
  • GET /qualifying/:qualifyingId

In V2, these endpoints have been split into two to clearly separate event metadata from results:

  • For races:

    • GET /races/:raceId — Returns information about the race API Reference.
    • GET /races/:raceId/results — Returns the full results API Reference.
    • GET /races/:raceId/grid-positions — Returns the grid positions API Reference.

  • For qualifying:

    • GET /qualifying/:qualifyingId — Returns information about the qualifying API Reference.
    • GET /qualifying/:qualifyingId/results — Qualifying results API Reference.

  • For practices:

    • GET /practices/:practiceId — Return information about the practice API Reference.
    • GET /practices/:practiceId/results — Results for the session API Reference.

This change improves clarity, performance, and consistency across endpoints.

Data Model Evolution (v1 → v2)​

In version 2 of the Hyprace Formula 1 API, the internal data model has been redesigned to better reflect the technical and organizational complexity of Formula 1 teams. The most important change is the shift from a simplified constructor model to a richer and more structured system involving distinct manufacturers and technical components.

V1 - From constructor to team and manufacturers​

In V1, the constructor field was overloaded:

  • It represented the team brand
  • It implicitly covered chassis and engine manufacturers
  • It could not model customer teams or hybrid setups

This simplification made it difficult to represent real-world historical and modern cases with accuracy (e.g Mercedes).

V2 - Team, Chassis Manufacturer, and Engine Manufacturer​

In V2, a team (also called a constructor team) is composed of multiple explicit manufacturers:

  • Chassis Manufacturer: Builds the car's main structure and aerodynamic body.
  • Engine Manufacturer: Provides the power unit and hybrid systems.
  • Tyre Manufacturer: Supplies the racing tyres that impact grip and strategy.
  • A Team Name that identifies the entrant (e.g. Mercedes-AMG PETRONAS Formula One Team)

This new structure separates identity (team) from the technical configuration (manufacturers), offering far greater precision.

Since 1981, all teams have been constructor teams, meaning the team itself designs and builds its chassis.

Historical note:
Before 1981, it was possible for multiple teams to compete using the same chassis manufacturer and thus share a constructor/chassis entry in the championship. (See the examples bellow)

Chassis & Engine Models per Manufacturer​

Each manufacturer (chassis or engine) now includes its own list of models. For example:

  • Ferrari (as a chassis manufacturer) may have multiple chassis models over time (e.g. SF-24, SF-23)
  • Mercedes (as an engine manufacturer) provides power units (e.g. M13 E Performance)

This allows:

  • Precise tracking of technical configurations by grand prix
  • Historical analysis of model evolution
  • Cross-team usage of the same engine or chassis model (e.g. Mercedes engines used by McLaren, Williams and Aston Martin for the 2025 season)

Standings by Manufacturer Pairing​

The standings are now tied to the technical pairing of chassis and engine manufacturers, not just the team name.

This reflects FIA’s logic for awarding Constructors' Championship points.

Multiple teams can contribute to the same manufacturer pairing in the standings. For example, two customer teams using the same chassis manufacturer and engine manufacturer may share points under that pairing.

Modern Example — 2024 Season​

PositionTeam NameChassis ManufacturerEngine ManufacturerTyre ManufacturerStandings KeyPoints
1McLaren F1 TeamMcLarenMercedesPirelliMcLaren + Mercedes545
2Scuderia FerrariFerrariFerrariPirelliFerrari + Ferrari520

Historical Example — McLaren in 1968​

PositionTeam NameChassis ManufacturerEngine ManufacturerStandings KeyPoints
2McLarenMcLarenFordMcLaren + Ford49
10McLarenMcLarenBRMMcLaren + BRM3

These are treated as separate technical entries in the standings.

The team Bruce McLaren Motor Racing entered the 1968 season using two different engine suppliers:

  • McLaren + Ford
  • McLaren + BRM

This team contributes to the McLaren + Ford and McLaren + BRM standings.

The team Anglo American Racers entered the 1968 season with McLaren + Ford.

This team contributes to the McLaren + Ford standing.

Historical Example — Scuderia Ferrari and NART in 1969​

Team NameChassis ManufacturerEngine ManufacturerStandings KeyPoints
Scuderia FerrariFerrariFerrariFerrari5
North American Racing Team (NART)FerrariFerrariFerrari2

In 1969, both Scuderia Ferrari and North American Racing Team (NART) used Ferrari chassis and engines but competed as separate teams.

Although Scuderia Ferrari and North American Racing Team (NART) used the same chassis manufacturer (Ferrari) and engine manufacturer (Ferrari), they were distinct teams with separate entries in the championship. Each team earned constructor points independently for their own team standings, but all points contributed collectively to the Ferrari chassis and Ferrari engine manufacturer tallies. Together, both teams contributed a total of 7 points during the 1969 season.

This example illustrates that, before 1981, multiple teams could compete using the same chassis and engine manufacturers as distinct entities. While each team scored points separately for their individual team championships, their results collectively counted toward the constructor championships of the chassis and engine manufacturers.