Formula 1 data reference
← All sports
Generated from GET /v2/sports/36. Not hand-maintained - if the API adds a status or renames a statistic, this page follows on the next build.
- Sport id
- 36
- Participants
- more
- Match clock
- no
- Incident positions
- no
Statuses 18
Every value event.status_id can take for this sport. Map onto this list rather than parsing status_type: ids are stable, labels are localized, and postponed matches keep status_type: scheduled.
| id | Name | Short | Type | Notes |
|---|---|---|---|---|
| 1 | Not started | Sched. | scheduled | clock stoppedset by incident 427 |
| 6 | Start delayed | Delay. | scheduled | clock stoppedset by incident 438 |
| 5 | Postponed | Post. | scheduled | clock stoppedset by incident 440TRAP: status_type is scheduled, exactly like a normal upcoming match. A postponed match is indistinguishable from a scheduled one unless you look at status_id. Never branch only on status_type. |
| 352 | Practice 1 | Practice 1 | live | |
| 353 | Practice 2 | Practice 2 | live | |
| 354 | Practice 3 | Practice 3 | live | |
| 355 | Qualifying 1 | Qualifying 1 | live | |
| 356 | Break after qualifying 1 | break q1 | live | |
| 357 | Qualifying 2 | Qualifying 2 | live | |
| 358 | Break after qualifying 2 | break q2 | live | |
| 359 | Qualifying 3 | Qualifying 3 | live | |
| 360 | Warm-up lap | Warm-up lap | live | |
| 361 | Awaiting start | Awaiting start | live | |
| 362 | Race in progress | Race | live | |
| 2 | Interrupted | Interr. | interrupted | clock stoppedset by incident 441Play stopped and may resume. Incident 1001 (Match resumed) brings it back. Distinct from Abandoned (7), which may never resume. |
| 7 | Abandoned | Abd. | interrupted | clock stoppedset by incident 442Play stopped and may never resume. Same status_type as Interrupted (2), so tell them apart by status_id. |
| 11 | Finished | Fin. | finished | clock stoppedset by incident 437One of FIVE terminal statuses (11, 12, 13, 14, 140). Treat every status_type: finished as terminal - checking for 11 alone misses matches decided in extra time, on penalties or in overtime. |
| 3 | Cancelled | Canc. | cancelled | clock stoppedset by incident 439 |
Results 2
Entries that can appear in participants[].results[], keyed by id. There is no score field - you select the result you need.
| id | Name | Code | Type | Data type |
|---|---|---|---|---|
| 411 | Winner | winner | team | binary |
| 412 | Progress | progress | team | binary |
Event details 20
Per-match metadata in the event's details, with the input type and allowed values.
| id | Name | Code | Input | Data type |
|---|---|---|---|---|
| 186 | Event type | event_type_formula | select | - |
| 8 | Weather conditions | weather_condition_id | select | - |
| 136 | Night event | night_event | select | - |
| 187 | Number of laps | number_of_laps | number | - |
| 188 | Current lap | current_lap | number | - |
| 189 | Track temperature | track_temperature | number | - |
| 190 | Air temperature | air_temperature | number | - |
| 191 | Humidity | humidity | number | - |
| 192 | Pressure | pressure | number | - |
| 193 | Wind speed | wind_speed | number | - |
| 141 | Attendance | attendance | number | - |
| 194 | Practice 1 start date | first_practice_start_date | datetime | - |
| 195 | Practice 2 start date | second_practice_start_date | datetime | - |
| 196 | Practice 3 start date | third_practice_start_date | datetime | - |
| 197 | Qualifying 1 start date | first_qualifications_start_date | datetime | - |
| 198 | Qualifying 2 start date | second_qualifications_start_date | datetime | - |
| 199 | Qualifying 3 start date | third_qualifications_start_date | datetime | - |
| 200 | Race start date | race_start_date | datetime | - |
| 205 | Has lineups | has_lineups | select | - |
| 251 | Handled participants | handled_participants | number | - |
Incidents 99
Incident types that can appear in this sport's events_incidents. category: emergency marks operational notices, not match events - never render them on a timeline.
| id | Name | Code | Type | Trader | Category | Notes |
|---|---|---|---|---|---|---|
| 2441 | Not started | not-started | event | yes | standard | |
| 2846 | The match will not be covered | the-match-will-not-be-covered | event | yes | emergency | emergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. The match will not be covered at all. The attribute gives the reason. Nothing further will arrive.Other: Scout's technical issues, Change of venue, Change of match date, Problems with TV transmission source |
| 2472 | Start delayed | start-delayed | event | yes | standard | |
| 2847 | Problems with the source of the broadcast | problems-with-the-source-of-the-broadcas | event | yes | emergency | emergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. The broadcast source has a problem. Paired with 2848 when it is solved. |
| 2449 | Practice 1 started | practice-1-started | event | yes | standard | |
| 2848 | Problem with the source of the broadcast has been solved | problem-with-the-source-of-the-broadcast | event | yes | emergency | emergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. The broadcast source problem is solved. |
| 2450 | Practice 2 started | practice-2-started | event | yes | standard | |
| 2849 | Change of coverage from venue to TV | change-of-coverage-from-venue-to-tv | event | yes | emergency | emergencyOperational notice, not a match event - category: emergency. It tells you the coverage SOURCE changed, which usually changes latency and can change how complete the statistics are. Never render it on a timeline. Before kick-off (group: prematch): moved from venue to TV. |
| 2451 | Practice 3 started | practice-3-started | event | yes | standard | |
| 2850 | Change of coverage from TV to venue | change-of-coverage-from-tv-to-venue | event | yes | emergency | emergencyOperational notice, not a match event - category: emergency. It tells you the coverage SOURCE changed, which usually changes latency and can change how complete the statistics are. Never render it on a timeline. Before kick-off (group: prematch): moved from TV to venue. |
| 2443 | Qualifying 1 started | qualifying-1-started | event | yes | standard | |
| 2851 | Change of coverage latency | change-of-coverage-latency | event | yes | emergency | emergencyOperational notice, not a match event - category: emergency. It tells you the coverage SOURCE changed, which usually changes latency and can change how complete the statistics are. Never render it on a timeline. Latency of the coverage changed. Relevant if you gate markets on feed delay.Other: from 3-6 to 7-15, from 7-15 to 3-6 |
| 2447 | Qualifying 2 started | qualifying-2-started | event | yes | standard | |
| 2852 | Scouting coverage can start with a delay of | scouting-coverage-can-start-with-a-delay | event | yes | emergency | emergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. Scouting coverage will start late. The attribute gives the size (under 3, 3-5 or 5-10 minutes).Other: < 3min, 3-5 min, 5-10 min |
| 2448 | Qualifying 3 started | qualifying-3-started | event | yes | standard | |
| 2853 | Expected delay in the start of the match | expected-delay-in-the-start-of-the-match | event | yes | emergency | emergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. The match will start late. The attribute gives the reason - a team arriving late, problems in the stands and so on.Other: Delayed arrival of a team, Problems in the stands, Referee problems, Infrastructure problems, Weather conditions |
| 2854 | Team line-ups will not be available | team-line-ups-will-not-be-available | event | yes | emergency | emergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. Line-ups will not be available for this match. Do not wait for lineups[] to fill. |
| 2452 | Warm-up lap | warm-up-lap | event | yes | standard | |
| 2855 | Source of the coverage is delayed | source-of-the-coverage-is-delayed | event | yes | emergency | emergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. The coverage source is delayed. The attribute gives the size of the delay (about 5 to 20 seconds).Other: ~5sec, ~10sec, ~15sec, ~20sec, ~25sec, ~30sec, >30sec |
| 2453 | Awaiting start | awaiting-start | event | yes | standard | |
| 2856 | The current part of the game has started with a delay | the-current-part-of-the-game-has-started | event | yes | emergency | emergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. The current period started late. |
| 2442 | Race started | race-started | event | yes | standard | |
| 2857 | Verification of result in progress | verification-of-result-in-progress | event | yes | emergency | emergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. A verification started. Whatever it covers may still change - hold off on caching it. |
| 2454 | Race in progress | race-in-progress | event | yes | standard | |
| 2858 | Verification of result completed and correct | verification-of-result-completed-and-cor | event | yes | emergency | emergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. Verification of the result finished. Values are confirmed. |
| 2455 | Restart race | restart-race | event | yes | standard | |
| 2859 | Verification of key statistics is in progress | verification-of-key-statistics-is-in-pro | event | yes | emergency | emergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. A verification started. Whatever it covers may still change - hold off on caching it. |
| 2444 | Break after | break-after | event | no | standard | |
| 2860 | Verification of key statistics completed and correct | verification-of-key-statistics-completed | event | yes | emergency | emergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. Verification of key statistics finished. Values are confirmed. |
| 2445 | Break after Qualifying 1 | break-after-q-1 | event | no | standard | |
| 2861 | Verification of game clock is in progress | verification-of-game-clock-is-in-progres | event | yes | emergency | emergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. A verification started. Whatever it covers may still change - hold off on caching it. |
| 2446 | Break after Qualifying 2 | break-after-q-2 | event | no | standard | |
| 2862 | Verification of game clock completed and correct | verification-of-game-clock-completed-and | event | yes | emergency | emergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. Verification of the game clock finished. Values are confirmed. |
| 2456 | Accident | accident | event | yes | standard | |
| 2863 | Match coverage interrupted due to technical issues | match-coverage-interrupted-due-to-techni | event | yes | emergency | emergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. Coverage stopped because of technical issues. 2864 or 2865 says whether it comes back. |
| 2457 | Yellow flag | yellow-flag | event | yes | standard | |
| 2864 | Match coverage will continue | match-coverage-will-continue | event | yes | emergency | emergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. Coverage will continue after the interruption. |
| 2458 | Green flag | green-flag | event | yes | standard | |
| 2865 | Match coverage will not continue | match-coverage-will-not-continue | event | yes | emergency | emergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. Coverage will NOT continue. Expect no further incidents for this match. |
| 2459 | Red flag | red-flag | event | yes | standard | |
| 2866 | The match is abandoned | the-match-is-abandoned | event | yes | emergency | emergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. The match was abandoned. The attribute gives the reason.Other: Problems in the stands, Referee problems, Infrastructure problems, Serious player injury, Weather conditions |
| 2460 | Blue flag | blue-flag | event | yes | standard | |
| 2867 | Waiting for official decision regarding match resumption | waiting-for-official-decision-regarding- | event | yes | emergency | emergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. Waiting for an official decision on whether the match resumes. 2868 or 2869 follows. |
| 2461 | Black flag | black-flag | event | yes | standard | |
| 2868 | Match will resume shortly | match-will-resume-shortly | event | yes | emergency | emergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. The match resumes shortly. |
| 2462 | Safety car | safety-car | event | yes | standard | |
| 2869 | Match will not resume | match-will-not-resume | event | yes | emergency | emergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. The match will not resume. |
| 2463 | Virtual safety car | virtual-safety-car | event | yes | standard | |
| 2870 | Expected delay in the start of the next part of the game | expected-delay-in-the-start-of-the-next- | event | yes | emergency | emergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. The next period will start late. The attribute gives the reason.Other: Problems in the stands, Referee problems, Infrastructure problems, Weather conditions |
| 2466 | DRS Disabled | drs-disabled | event | yes | standard | |
| 2871 | Change of coverage from venue to TV | change-of-coverage-from-venue-to-tv-live | event | yes | emergency | emergencyOperational notice, not a match event - category: emergency. It tells you the coverage SOURCE changed, which usually changes latency and can change how complete the statistics are. Never render it on a timeline. During play (group: live): moved from venue to TV. |
| 2467 | DRS enabled | drs-enabled | event | yes | standard | |
| 2872 | Change of coverage from TV to venue | change-of-coverage-from-tv-to-venue-live | event | yes | emergency | emergencyOperational notice, not a match event - category: emergency. It tells you the coverage SOURCE changed, which usually changes latency and can change how complete the statistics are. Never render it on a timeline. During play (group: live): moved from TV to venue. |
| 2464 | Possible rain | possible-rain | event | yes | standard | |
| 2873 | Change of coverage latency | change-of-coverage-latency-live | event | yes | emergency | emergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. Coverage latency changed. The attribute gives the direction, for example from 3-6 to 7-15 seconds. Relevant if you gate markets on feed delay.Other: from 3-6 to 7-15, from 7-15 to 3-6 |
| 2465 | Rain | rain | event | yes | standard | |
| 2874 | Expected delay in the start of the match - safety reasons | expected-delay-in-the-start-of-the-match | event | yes | emergency | emergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. The match will start late for safety reasons. |
| 2468 | Pit exit open | pit-exit-open | event | yes | standard | |
| 2875 | Verification of key statistics is in progress | verification-of-key-statistics-is-in-pro | event | yes | emergency | emergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. A verification started. Whatever it covers may still change - hold off on caching it. |
| 2469 | Pit exit closed | pit-exit-closed | event | yes | standard | |
| 2876 | Verification of key statistics completed and correct | verification-of-key-statistics-completed | event | yes | emergency | emergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. Verification of key statistics, after the match finished. Values are confirmed. |
| 2470 | Incident under investigation | investigation | event | yes | standard | |
| 2877 | Verification of player names for key incidents in progress | verification-of-names-for-key-incidents- | event | yes | emergency | emergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. A verification started. Whatever it covers may still change - hold off on caching it. |
| 2471 | Chequered flag | chequered-flag | event | yes | standard | |
| 2878 | Verification of player names for key incidents completed and correct | verification-of-names-for-key-incidents- | event | yes | emergency | emergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. Verification of player names on key incidents finished. Values are confirmed. |
| 2473 | Finished | finished | event | yes | standard | |
| 2879 | Verification of result is in progress | verification-of-result-is-in-progress | event | yes | emergency | emergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. A verification started. Whatever it covers may still change - hold off on caching it. |
| 2474 | Interrupted | interrupted | event | yes | standard | |
| 2880 | Verification of result completed and correct | verification-of-result-completed-and-cor | event | yes | emergency | emergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. Verification of the result, after the match finished. Values are confirmed. |
| 2475 | Postponed | postponed | event | yes | standard | |
| 2881 | Problems with the low latency source of the coverage | problems-with-the-low-latency-source-of- | event | yes | emergency | emergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. The low-latency source has a problem. Paired with 2882. |
| 2476 | Abandoned | Abandoned | event | yes | standard | |
| 2882 | Problems with the low latency source of coverage has been solved | problems-with-the-low-latency-source-of- | event | yes | emergency | emergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. The low-latency source problem is solved. |
| 2477 | Cancelled | Cancelled | event | yes | standard | |
| 2883 | Player name verification is in progress - substitution | player-name-verification-is-in-progress- | event | yes | emergency | emergencyOperational notice, not a match event - category: emergency. Never render it on a timeline. A verification started. Whatever it covers may still change - hold off on caching it. |
| 1000 | Betstart | betstart | event | yes | standard | marketBetting markets may be activated. Other: Master |
| 1010 | Betstop | betstop | event | yes | standard | marketAll betting markets are closed: a goal, penalty or red card looks likely, or the situation on the pitch is unclear. Other: Master |
| 1001 | Match resumed | match-resumed | event | yes | standard | informingUsed when an interrupted match resumes. |
| 1200 | Technical problems | technical-problems | event | yes | standard | marketTechnical problems during coverage. Closes all match markets automatically. |
| 2478 | Lap completed by leader | lap-completed-by-leader | team | yes | standard | |
| 2479 | New leader | new-leader | team | yes | standard | |
| 2480 | End of race | end-of-race | team | yes | standard | |
| 2481 | Problem with bolid | problem-with-bolid | team | yes | standard | |
| 2482 | Bolid failure | bolid-failure | team | yes | standard | |
| 2483 | Bolid collision | bolid-collision | team | yes | standard | |
| 2484 | Lap record | lap-record | team | yes | standard | |
| 2485 | Track record | track-record | team | yes | standard | |
| 2486 | Sector 1 record | sector-1-record | team | yes | standard | |
| 2487 | Sector 2 record | sector-2-record | team | yes | standard | |
| 2488 | Sector 3 record | sector-3-record | team | yes | standard | |
| 2489 | Penalty | penalty | team | yes | standard | |
| 2490 | Pit stop | pit-stop | team | yes | standard | |
| 2491 | Pit-lane start | pit-lane-start | team | yes | standard | |
| 2492 | Did not start | did-not-start | team | yes | standard | |
| 2493 | Did not finish | did-not-finish | team | yes | standard | |
| 2494 | Disqualified | disqualified | team | yes | standard | |
| 2495 | Finished | driver_finished | team | yes | standard | |
| 2496 | Did not qualify | did-not-qualify | team | yes | standard | |
| 2497 | Position change | position-change | team | yes | standard |
Standings types 10
Values for type_name on /v2/standings. Pick the one you need and match its columns by code, not by position.
| id | Name |
|---|---|
| 103 | Constructors classification |
| 102 | Drivers classification |
| 173 | Fastest laps |
| 108 | Practice results |
| 110 | Qualification 1 results |
| 111 | Qualification 2 results |
| 112 | Qualification 3 results |
| 107 | Qualification results |
| 106 | Race results |
| 109 | Starting list |
Statistics 44
Split into team statistics (in participants[].stats) and person statistics (in sub_participants[].stats). Match by code, not by position.
Team 5
| id | Name | Code | Data type |
|---|---|---|---|
| 564 | Total rank | total_rank | integer |
| 733 | Gap | gap | text |
| 757 | Total time | total_time | milli_time |
| 762 | Average speed | average_speed | decimal |
| 75 | Points | points | integer |
Person 39
| id | Name | Code | Data type |
|---|---|---|---|
| 731 | Grid | grid | integer |
| 564 | Total rank | total_rank | integer |
| 732 | Current rank | current_rank | integer |
| 733 | Gap | gap | text |
| 734 | Interval | interval | milli_time |
| 735 | Last lap time | last_lap_time | milli_time |
| 736 | Best lap time | best_lap_time | milli_time |
| 737 | 1st sector last time | first_sector_last_time | milli_time |
| 738 | 2nd sector last time | second_sector_last_time | milli_time |
| 739 | 3rd sector last time | third_sector_last_time | milli_time |
| 740 | Number of pit-stops | number_of_pit_stops | integer |
| 741 | Current tyres | current_tyres | text |
| 742 | Tyres 1 | first_tires | text |
| 743 | Number of laps on tyres 1 | number_of_laps_first_tires | integer |
| 744 | Tyres 2 | second_tires | text |
| 745 | Number of laps on tyres 2 | number_of_laps_second_tires | integer |
| 746 | Tyres 3 | third_tires | text |
| 747 | Number of laps on tyres 3 | number_of_laps_third_tires | integer |
| 750 | Tyres 4 | fourth_tires | text |
| 751 | Number of laps on tyres 4 | number_of_laps_fourth_tires | integer |
| 752 | Tyres 5 | fifth_tires | text |
| 753 | Number of laps on tyres 5 | number_of_laps_fifth_tires | integer |
| 754 | Sector 1 highest speed | first_sector_highest_speed | decimal |
| 755 | Sector 2 highest speed | second_sector_highest_speed | decimal |
| 756 | Sector 3 highest speed | third_sector_highest_speed | decimal |
| 757 | Total time | total_time | milli_time |
| 758 | Total laps | total_laps | integer |
| 759 | Pit stops number | pit_stops_number | integer |
| 760 | Status | status | select |
| 761 | Number of laps | number_of_laps | integer |
| 762 | Average speed | average_speed | decimal |
| 75 | Points | points | integer |
| 763 | Qualifying 1 time | qualifying_first_time | milli_time |
| 764 | Qualifying 2 time | qualifying_second_time | milli_time |
| 765 | Qualifying 3 time | qualifying_third_time | milli_time |
| 1135 | Qualifying laps | qualifying_laps | integer |
| 766 | Practice 1 time | practice_first_time | milli_time |
| 767 | Practice 2 time | practice_second_time | milli_time |
| 768 | Practice 3 time | practice_third_time | milli_time |