GET api/[year]/[round]/race

This endpoint retrieves the results of the race of the given round.

Example Response

{
  "api": "https://f1connectapi.vercel.app",
  "url": "https://f1connectapi.vercel.app/api/2024/1/race?limit=1",
  "limit": 1,
  "offset": 0,
  "total": 1,
  "races": {
    "round": "1",
    "date": "2024-03-02",
    "time": "15:00:00Z",
    "url": "https://en.wikipedia.org/wiki/2024_Bahrain_Grand_Prix",
    "raceId": "bahrein_2024",
    "raceName": "Gulf Air Bahrain Grand Prix 2024",
    "circuit": {
      "circuitId": "bahrein",
      "circuitName": "Bahrein International Circuit",
      "country": "Bahrein",
      "city": "Sakhir",
      "circuitLength": "5412km",
      "lapRecord": "1:31:447",
      "firstParticipationYear": 2004,
      "corners": 15,
      "fastestLapDriverId": "de_la_rosa",
      "fastestLapTeamId": "mclaren",
      "fastestLapYear": 2005,
      "url": "https://en.wikipedia.org/wiki/Bahrain_International_Circuit"
    },
    "results": [
      {
        "position": 1,
        "points": 26,
        "grid": 1,
        "time": "1:31:44",
        "fastLap": null,
        "retired": null,
        "driver": {
          "driverId": "max_verstappen",
          "number": 33,
          "shortName": "VER",
          "url": "https://en.wikipedia.org/wiki/Max_Verstappen",
          "name": "Max",
          "surname": "Verstappen",
          "nationality": "Netherlands",
          "birthday": "30/09/1997"
        },
        "team": {
          "teamId": "red_bull",
          "teamName": "Red Bull Racing",
          "nationality": "Austria",
          "firstAppareance": 2005,
          "constructorsChampionships": 6,
          "driversChampionships": 8,
          "url": "https://en.wikipedia.org/wiki/Red_Bull_Racing"
        }
      }
    ]
  }
}

Response Types

Field	Type	Description
round	string	The race round of the championship.
date	string	The race date in format YYYY-MM-DD.
time	string	The race time in format HH:MM:SS.
url	string	A URL to the Wikipedia page of the race.
raceId	string	The race id.
raceName	string	The race name.
circuit	object	The circuit object.
circuitId	string	The circuit id.
circuitName	string	The circuit name.
country	string	The circuit country.
city	string	The circuit city.
circuitLength	string	The circuit length in kilometers.
lapRecord	string	The lap record for the circuit.
firstParticipationYear	number	The year the circuit first hosted a Grand Prix.
corners	number	The number of corners on the circuit.
fastestLapDriverId	string	The driverId of the fastest lap driver.
fastestLapTeamId	string	The teamId of the fastest lap team.
fastestLapYear	number	The year the fastest lap was set.
url	string	A URL to the Wikipedia page of the circuit.
results	array	A list of race results objects returned from the API.
position	number	The finishing position of the driver in the race.
points	number	The grid position of the driver.
grid	number	The finishing position of the driver in the race.
time	string	The time of the driver in the race.
fastLap	string \| null	Fast lap of the driver in the race.
retired	string \| null	If the driver is retired or not.
driver	object	The driver object.
driverId	string	The driver id.
name	string	The driver's first name.
surname	string	The driver's surname.
nationality	string	The driver's nationality.
birthday	string	The driver's birthday in DD/MM/YYYY format.
number	number	The driver's racing number.
shortName	string	The driver's abbreviated name, often used in standings or graphics.
url	string	A URL to the Wikipedia page of the driver.
team	object	The team object.
teamId	string	The team id.
teamName	string	The team name.
nationality	string	The team nationality.
firstAppareance	number	The year the team first appeared in a Grand Prix.
constructorsChampionships	number	The number of constructors championships the team has won.
driversChampionships	number	The number of drivers championships the team has won.
url	string	A URL to the Wikipedia page of the team.

Response Params

Param	Default	Data
limit	30	Number of records returned per request.
offset	0	Number of records skipped before starting to fetch.
timezone	-	Timezone to use for the dates. If not provided, the default timezone is used.

Response Status

Status	Description
200	Successful request
404	Resource not found
500	Internal server error

More Results endpoints See other endpoints