Overview
- GET /api/f1/drivers
- GET /api/f1/{year}/drivers
- PARAMETERS /api/f1/{year}/drivers
- GET /api/f1/{year}/{round}/drivers
- PARAMETERS /api/f1/{year}/{round}/drivers
- GET /api/f1/drivers/{driverid}
- PARAMETERS /api/f1/drivers/{driverid}
- GET /api/f1/constructors
- GET /api/f1/{year}/constructors
- PARAMETERS /api/f1/{year}/constructors
- GET /api/f1/{year}/{round}/constructors
- PARAMETERS /api/f1/{year}/{round}/constructors
- GET /api/f1/constructors/{constructorid}
- PARAMETERS /api/f1/constructors/{constructorid}
- GET /api/f1/circuits.json
- GET /api/f1/{year}/circuits
- PARAMETERS /api/f1/{year}/circuits
- GET /api/f1/{year}/{round}/circuits
- PARAMETERS /api/f1/{year}/{round}/circuits
- GET /api/f1/circuits/{circuitid}
- PARAMETERS /api/f1/circuits/{circuitid}
- GET /api/f1/seasons
- GET /api/f1/{year}/{round}/results
- PARAMETERS /api/f1/{year}/{round}/results
- GET /api/f1/current/last/results
- GET /api/f1/{year}/{round}/qualifying
- PARAMETERS /api/f1/{year}/{round}/qualifying
- GET /api/f1/{year}
- PARAMETERS /api/f1/{year}
- GET /api/f1/current
- GET /api/f1/{year}/{round}
- PARAMETERS /api/f1/{year}/{round}
- GET /api/f1/{year}/{round}/driverStandings
- PARAMETERS /api/f1/{year}/{round}/driverStandings
- GET /api/f1/{year}/{round}/constructorStandings
- PARAMETERS /api/f1/{year}/{round}/constructorStandings
- GET /api/f1/{year}/driverStandings
- PARAMETERS /api/f1/{year}/driverStandings
- GET /api/f1/{year}/constructorStandings
- PARAMETERS /api/f1/{year}/constructorStandings
- GET /api/f1/current/driverStandings
- GET /api/f1/current/constructorStandings
- GET /api/f1/driverStandings/1
- GET /api/f1/constructorStandings/1
- GET /api/f1/drivers/{driverid}/driverStandings
- PARAMETERS /api/f1/drivers/{driverid}/driverStandings
- GET /api/f1/constructors/{constructorid}/constructorStandings
- PARAMETERS /api/f1/constructors/{constructorid}/constructorStandings
- GET /api/f1/status
- GET /api/f1/{year}/status
- PARAMETERS /api/f1/{year}/status
- GET /api/f1/{year}/{round}/status
- PARAMETERS /api/f1/{year}/{round}/status
- GET /api/f1/{year}/{round}/laps/{lapnumber}
- PARAMETERS /api/f1/{year}/{round}/laps/{lapnumber}
- GET /api/f1/{year}/{round}/pitstops
- PARAMETERS /api/f1/{year}/{round}/pitstops
- GET /api/f1/{year}/{round}/pitstops/{pitstopnumber}
- PARAMETERS /api/f1/{year}/{round}/pitstops/{pitstopnumber}
GET /api/f1/drivers
Summary: List of all drivers
To obtain a list of all drivers.
Driver lists can be refined by adding one or more of the following criteria:
/circuits/
For example, to list all drivers who have driven for a specific constructor at a particular circuit:
http://ergast.com/api/f1/constructors/mclaren/circuits/monza/drivers
Alternatively, to list the drivers who have achieved a particular final position in the championship:
http://ergast.com/api/f1/driverStandings/1/drivers
Drivers who participated in the 2014 season onwards have a permanent driver number.
OpenAPI snippet URL
GET /api/f1/{year}/drivers
Summary: List of all drivers within a year
This endpoint is to obtain a list of all drivers in a particular season (year)
OpenAPI snippet URL
PARAMETERS /api/f1/{year}/drivers
OpenAPI snippet URL
GET /api/f1/{year}/{round}/drivers
Summary: List of all drivers within a race in a year
This endpoint is to obtain a list of all drivers in a particular race(round) of a season(year)
OpenAPI snippet URL
PARAMETERS /api/f1/{year}/{round}/drivers
OpenAPI snippet URL
GET /api/f1/drivers/{driverid}
Summary: Driver Information
Each driver listed in the response is identified by a unique driverId which is used to identify the driver throughout the API. To obtain information about a particular driver append the driverId
This endpoint is to obtain the information of a particular driver based on the driverid (driver name)
OpenAPI snippet URL
PARAMETERS /api/f1/drivers/{driverid}
OpenAPI snippet URL
GET /api/f1/constructors
Summary: List of all constructors
This endpoint is to obtain a list of all constructors.
Constructor lists can be refined by adding one or more of the following criteria:
/circuits/
For example, to list all constructors a specific driver has driven for at a particular circuit:
http://ergast.com/api/f1/drivers/alonso/circuits/monza/constructors
Alternatively, to list all the constructors who have achieved a particular final position in the championship:
http://ergast.com/api/f1/constructorStandings/1/constructors
OpenAPI snippet URL
GET /api/f1/{year}/constructors
Summary: List of all constructors within a year
This endpoint is to obtain a list of all constructors in a particular season (year)
OpenAPI snippet URL
PARAMETERS /api/f1/{year}/constructors
OpenAPI snippet URL
GET /api/f1/{year}/{round}/constructors
Summary: List of all constructors within a race in a year
This endpoint is to obtain a list of all constructors in a particular race(round) of a season(year)
OpenAPI snippet URL
PARAMETERS /api/f1/{year}/{round}/constructors
OpenAPI snippet URL
GET /api/f1/constructors/{constructorid}
Summary: Constructor Information
Each constructor listed in the response is identified by a unique constructorId which is used to identify the constructor throughout the API. To obtain information about a particular constructor append the constructorId (name of the constructor)
This endpoint is to obtain the information of a particular constructor based on the constructorId (constructor name)
OpenAPI snippet URL
PARAMETERS /api/f1/constructors/{constructorid}
OpenAPI snippet URL
GET /api/f1/circuits.json
Summary: List of all circuits
This endpoint is to obtain a list of all constructors.
Circuit lists can be refined by adding one or more of the following criteria:
/constructors/
For example, to list all circuits at which a specific driver has driven for a particular constructor:
http://ergast.com/api/f1/drivers/alonso/constructors/mclaren/circuits
OpenAPI snippet URL
GET /api/f1/{year}/circuits
Summary: List of all circuits within a year
List of all circuits within a year
OpenAPI snippet URL
PARAMETERS /api/f1/{year}/circuits
OpenAPI snippet URL
GET /api/f1/{year}/{round}/circuits
Summary: List of all circuits within a race in a year
List of all circuits within a race in a year
OpenAPI snippet URL
PARAMETERS /api/f1/{year}/{round}/circuits
OpenAPI snippet URL
GET /api/f1/circuits/{circuitid}
Summary: Circuit Information
Each constructor listed in the response is identified by a unique circuitId which is used to identify the constructor throughout the API. To obtain information about a particular circuit append the circuitId (name of the circuit)
This endpoint is to obtain the information of a particular circuit based on the circuitId (circuit name)
OpenAPI snippet URL
PARAMETERS /api/f1/circuits/{circuitid}
OpenAPI snippet URL
GET /api/f1/seasons
Summary: Seasons List
This endpoint gives the seasons currently supported by the API.
Season lists can be refined by adding one or more of the following criteria:
/circuits/
For example, to list all seasons where a specific driver has driven for a particular constructor:
http://ergast.com/api/f1/drivers/alonso/constructors/renault/seasons
Alternatively, to list the seasons where a specific driver or constructor has achieved a particular final position in the championship:
http://ergast.com/api/f1/drivers/alonso/driverStandings/1/seasons http://ergast.com/api/f1/constructors/renault/constructorStandings/1/seasons
OpenAPI snippet URL
GET /api/f1/{year}/{round}/results
Summary: Race Result
This endpoint gives the result for a specific race (round) in a season(year).
If the results for the specified race are not yet available the RaceTable element in the response will be empty.
OpenAPI snippet URL
PARAMETERS /api/f1/{year}/{round}/results
OpenAPI snippet URL
GET /api/f1/current/last/results
Summary: Most recent race result
Results from the most recent race can be obtained using this endpoint.
OpenAPI snippet URL
GET /api/f1/{year}/{round}/qualifying
Summary: Qualifying Results
Qualifying Results
OpenAPI snippet URL
PARAMETERS /api/f1/{year}/{round}/qualifying
OpenAPI snippet URL
GET /api/f1/{year}
Summary: Schedule of races for a season
To obtain the schedule of races for a specific season use this endpoint required season (year).
OpenAPI snippet URL
PARAMETERS /api/f1/{year}
OpenAPI snippet URL
GET /api/f1/current
Summary: Schedule of the current season
To obtain the schedule of races for the current season, use this endpoint.
OpenAPI snippet URL
GET /api/f1/{year}/{round}
Summary: Info about a specific race
To obtain the schedule of races for a specific race(round) in a season(year), use this endpoint.
OpenAPI snippet URL
PARAMETERS /api/f1/{year}/{round}
OpenAPI snippet URL
GET /api/f1/{year}/{round}/driverStandings
Summary: Driver standings after a race
To fetch the driver standings after a specific race(round) in a season(year), use this endpoint.
OpenAPI snippet URL
PARAMETERS /api/f1/{year}/{round}/driverStandings
OpenAPI snippet URL
GET /api/f1/{year}/{round}/constructorStandings
Summary: Constructor standings after a race
To list the constructor standings after a specific race (round) in a season(year), use this endpoint.
OpenAPI snippet URL
PARAMETERS /api/f1/{year}/{round}/constructorStandings
OpenAPI snippet URL
GET /api/f1/{year}/driverStandings
Summary: Season end driver standings
Driver Standings at the end of the season(year).
OpenAPI snippet URL
PARAMETERS /api/f1/{year}/driverStandings
OpenAPI snippet URL
GET /api/f1/{year}/constructorStandings
Summary: Season end constructor standing
Constructor Standings at the end of the season(year).
OpenAPI snippet URL
PARAMETERS /api/f1/{year}/constructorStandings
OpenAPI snippet URL
GET /api/f1/current/driverStandings
Summary: Current drivers’ standing
Current driver standings can always be obtained using this endpoint.
OpenAPI snippet URL
GET /api/f1/current/constructorStandings
Summary: Current constructor’s standing
Current constructor standings can always be obtained using this endpoint.
OpenAPI snippet URL
GET /api/f1/driverStandings/1
Summary: All winners of drivers’ championships
To fetch all the winners information of drivers.
OpenAPI snippet URL
GET /api/f1/constructorStandings/1
Summary: All winners of constructors’ championships
To fetch all the winners information of constructors.
OpenAPI snippet URL
GET /api/f1/drivers/{driverid}/driverStandings
Summary: Driver standings by specifying the driver
Driver standings by giving in the driverid(name of the driver).
OpenAPI snippet URL
PARAMETERS /api/f1/drivers/{driverid}/driverStandings
OpenAPI snippet URL
GET /api/f1/constructors/{constructorid}/constructorStandings
Summary: Constructor standings by specifying the constructor
Constructor standings by giving in the constructorid(name of the constructor).
OpenAPI snippet URL
PARAMETERS /api/f1/constructors/{constructorid}/constructorStandings
OpenAPI snippet URL
GET /api/f1/status
Summary: List of all finishing status codes
Every driver has a finishing status like ‘finished’, disqualified’, ‘accident’, ‘+1 lap’, ‘+2 lap’, etc. This endpoint will give the list of all such statuses. Example request and response attached
OpenAPI snippet URL
GET /api/f1/{year}/status
Summary: List of finishing status for a specific season
To fetch the list of finishing status of a specific season(year).
OpenAPI snippet URL
PARAMETERS /api/f1/{year}/status
OpenAPI snippet URL
GET /api/f1/{year}/{round}/status
Summary: List of finishing status for a specific round in a season
To fetch the list of finishing status of a specific race(round) in a season(year).
OpenAPI snippet URL
PARAMETERS /api/f1/{year}/{round}/status
OpenAPI snippet URL
GET /api/f1/{year}/{round}/laps/{lapnumber}
Summary: Lap time
This endpoint requires the season(year), race(round) and lap number(lapnumber) to be specified.
OpenAPI snippet URL
PARAMETERS /api/f1/{year}/{round}/laps/{lapnumber}
OpenAPI snippet URL
GET /api/f1/{year}/{round}/pitstops
Summary: Pit stop data for a race
This endpoint requires the season(year) and race(round) to be specified.
OpenAPI snippet URL
PARAMETERS /api/f1/{year}/{round}/pitstops
OpenAPI snippet URL
GET /api/f1/{year}/{round}/pitstops/{pitstopnumber}
Summary: Information for a specific pit stop
This endpoint requires the season(year), race(round) and pit stop number(pitstopnumber) to be specified.
OpenAPI snippet URL
PARAMETERS /api/f1/{year}/{round}/pitstops/{pitstopnumber}
OpenAPI snippet URL