Formula E Statistics Feeds 2018 1 SPORTRADAR FORMULA E STATISTICS FEEDS
Table of Contents Formula E Statistics Feeds... 3 Competitor Information... 4 Team Information... 5 Stage Information... 6 Results Information... 7 Probability Information... 8 Frequently Asked Questions... 9 Document Change History... 12 2 SPORTRADAR FORMULA E STATISTICS FEEDS
Formula E Statistics Feeds We package our comprehensive stats collection into the following feeds, each focused on serving specific information needs: provides detailed driver information including debut date, first points, first pole, and first victories. Seasons - displays a listing of Formula 1 seasons with respective stage IDs. This is the starting point for the Formula E API. returns the outrights for each driver for a given race. returns the schedule for a given stage. returns stage and result information for each competitor and team. Team Profile provides detailed team information including car details, engine type, and debut date, first points, first pole, first victories, and relevant staff information. 3 SPORTRADAR FORMULA E STATISTICS FEEDS
Competitor Information Stat Feeds Element Attribute Format Country Code competitor country_code String Date of Birth info dateofbirth Date Debut info debut Date First Points Date info first_points Date First Pole Date info first_pole Date First Victory Date info first_victory Date Gender competitor gender String Height info height Integer Id competitor id GUID Name competitor name String Nationality competitor nationality String Official Website info url_official String Origin Country info country String Origin Country Code info country_code String Place of Birth info placeofbirth String Salary info salary Integer Vehicle Nickname info vehicle_nickname String WCS Won info wcs_won Integer Weight info weight Integer 4 SPORTRADAR FORMULA E STATISTICS FEEDS
Team Information Stat Feeds Element Attribute Format Country Code Gender Id Name Nationality Team Profile Team Profile Team Profile Team Profile Team Profile team country_code String team gender String team id GUID team name String team nationality String 5 SPORTRADAR FORMULA E STATISTICS FEEDS
Stage Information Stat Feeds Element Attribute Format Description Id Pit Open Scheduled Scheduled End Status Type Seasons Seasons Seasons Seasons Seasons stage description String stage id GUID stage pit_open Boolean stage scheduled Date/Time stage scheduled_end Date/Time stage status String stage type String 6 SPORTRADAR FORMULA E STATISTICS FEEDS
Results Information Stat Feeds Element Attribute Format Fanboost result fanboost Boolean Fastest Lap Time result fastest_lap_time String Fastest Laps result fastest_laps String Grid result grid Integer Laps result laps Integer Pitstop Count result pitstop_count Integer Podiums result podiums Integer Points result points Integer Pole Positions result pole_positions Integer Position result position Integer Races result races Integer Races with Points result races_with_points Integer Status result status String Substatus result substatus String Time result time String Vehicle Number result vehicle_number Integer Victories result victories Integer 7 SPORTRADAR FORMULA E STATISTICS FEEDS
Probability Information Stat Feeds Element Attribute Format Market Description market description String Market Name market name GUID Market Type market type String Outcome Id outcome id Date/Time Outcome Name outcome name String Outcome Probability outcome probability String 8 SPORTRADAR FORMULA E STATISTICS FEEDS
Frequently Asked Questions Q: How does the stage system work? A: The Formula E API uses generic stage implementation. The core of the API is built around the concept of stages. For example, an event contains the following stage types: practice, qualifying, and race. Each of those stages, in turn, have stages (except Practice which has no sub-stages). The IDs of each stage are usable in the URL path to request information about that particular stage. Qualifying stages contain substages known as "Qualifying Parts". In the Race stages, the sub-stages are laps. You can use the lap stage ID in the URL to get specific lap details, including driver times, and position. The Formula E sport and seasons within it are stages as well. The sport stage consists of season stages for each annual season. Using the ID of a chosen season as a parameter in the endpoint you can "drill down" into each season. For example, using the 2018 season ID as a parameter in the endpoint, the sub-stages will be individual race events. From the race event, you can drill down into the practice, qualifying, race, and lap stages of a race using the same endpoint with different stage IDs. The best way to 'start' the navigation with the Formula E API is using the Seasons endpoint. From there one can obtain the stage ID for the season required and use that as a parameter in the endpoint. Stage Type Sport Season Event Practice Qualifying Qualifying Part Race Lap Information Included Information about the seasons included. Which is limited to the current and previous season only. Note probabilities do not return valid data on this stage. Contains the season schedule, driver and team standings and statistics. Information about a single event, the competitors, the teams, and the circuit. Competitors and results of practice such as fastest time etc. Information pertaining to the qualifying stage of the event including conditions, competitors, and overall qualifying results. Information about the individual qualifying parts of the overall qualifying stage such as conditions, competitors, and results. Details of the race itself including the competitors, lap by lap, and overall results. Specific details on individual laps such as driver positions, times, etc. Note probabilities do not return valid data on this stage. Sub-stages Formula E seasons: 2017, 2018. Events on the Formula E calendar for that season Sessions (eg: Practice, Qualifying, Race) None Qualifying Parts None Laps None. 9 SPORTRADAR FORMULA E STATISTICS FEEDS
Q: What are the stage types I can expect to see in the feeds? A: Here are the Formula E stage: sport season event practice qualifying qualifying_part race lap Q: How do I see the Championship points table? A: Use the stage summary endpoint and a season stage ID as the parameter. The competitors node lists competitors, ranked with points, position, victories, races, races with points, and podiums. Q: How do I know what 'stage' I am currently looking at? A: Each stage has a 'stage' element. The stage element has an attribute 'type' displays stage type. The different valid stage types are listed above. Q: How do I get the probabilities for the entire Championship? Or only one race? A: You can use season, event, and race stage IDs as parameters for the probabilities endpoint. Probabilities are available for the individual driver to win the season, a single event, and race stage. Probabilities are not available on the Sport, Practice, Qualifying, or Lap stages. Q: How do I look up information about teams? A: Use the Team Profile endpoint with the required driver's competitor ID. The best place to get the driver's ID is the endpoint, using the season stage ID as the parameter. Most stages will include driver and team IDs. Q: How do I retrieve information about an individual driver? A: Use the endpoint with the required driver's competitor ID. The best place to get the driver's competitor ID is the endpoint, using the season stage ID. Q: What races are covered in the Formula E API? A: The entire Formula E Championship. Q: Is it updated in real-time? A: No, the Formula E API provides lap by lap updates? Q: Does this API include Qualifying and Practice sessions? A: Yes, qualifying stages are all covered lap by lap. Practice sessions are updated post-session. 10 SPORTRADAR FORMULA E STATISTICS FEEDS
Q: What are the possible statuses of a race or stage? A: Here are the possible race and stage statuses: cancelled finished running not_started completed closed preliminary Q: What is the Date format? A: When we present date only values we present these in the ISO 8601 standard format. ex: 2013-04-03 We use these for attributes that have date and no time (such as birthdate). For more information: https://en.wikipedia.org/wiki/iso_8601 Q: What time zone are the date time fields presented in? A: All our Date/Time attributes are in UTC, presented in the ISO 8601 standard format. ex: 2013-04- 03T18:15:00+00:00 For more information: https://en.wikipedia.org/wiki/iso_8601 Q: Where are the race probabilities for Formula E? A: At this time, Sportradar only provides probabilities at the championship level for Formula E. 11 SPORTRADAR FORMULA E STATISTICS FEEDS
Document Change History Date Section Change 05/10/2018 All Initial release 12 SPORTRADAR FORMULA E STATISTICS FEEDS