UOF - Stage structure in Formula 1

Formula 1 is one of the sports offered by Sportradar with Sport ID = 40 and it is retrievable among all the sports offered by Sportradar in the “All available sports” UOF API end point (see screenshot below).

The events related to Formula 1 are organized into stages as shown in the following schema.

The tournament "Formula 1 2020" for example is a stage.

All the Grands Prix events which are related to Formula 1 2020 are parent stages.

Events such as qualifying, practice and race are “child” stages of the previous ones.

The schema is represented in the following picture:

How to retrieve Formula 1 stage information by means of the UOF API End Points

Information related to stages (normal stages, parent and child) can be easily retrieved thanks to the UOF API End points.

Starting from the highest level, it is possible to query the end points and get down to lower levels such as practice, qualifying and race events which are child stages.

Here is an example keeping into consideration again Formula 1 2020.

Step 1.

Insert sport id (40 in this case) into the tournament end point in order to find all the tournaments available related to such a sport.

The answer provides the list of the tournaments which are, in this case, Formula 1 2019 and Formula 1 2020. The 2 tournaments are shown in the tournament element and identified as stages.

The id which identifies Formula 1 2020 is a stage ID, in this case 547803 (see the part underlined in red).

Step 2.

Insert stage 547803 into the schedule end point.

The schedule end point provides as an answer the list of the Grands Prix which are in Formula 1 2020.

Each Grands Prix is inserted in a sport_event element and identified by a stage ID.

The attribute “type” defines if the stage is parent or child.

Step 3.

Insert stage 550771 into the summary end point.

The summary end point provides detailed info related to the event.

Inserting the parent stage into the filter for the end point, it is possible to retrieve all the child events.

The element “races” provides a list of sport_event elements which are identified with a stage ID and which are described by the stage_type.

The stage_type shows if the event is a practise, a qualifying or a race event.

Step 4.

Insert stage 550787 into the summary end point or into the fixture end point.

Once the stage ID of the race has been retrieved, then it is possible to gather more information in regards (scheduling, ending time, parent stage, tournament etc.)