This endpoint retrieves details about a driver in the database. Based on the provided driverId and year.
{
"api": "https://f1connectapi.vercel.app",
"url": "https://f1connectapi.vercel.app/api/2024/drivers/alonso?limit=1&offset=4",
"limit": 1,
"offset": 4,
"total": 1,
"season": "2024",
"championshipId": "f1_2024",
"driver": {
"driverId": "alonso",
"name": "Fernando",
"surname": "Alonso",
"nationality": "Spain",
"birthday": "29/07/1981",
"number": 14,
"shortName": "ALO",
"url": "https://en.wikipedia.org/wiki/Fernando_Alonso"
},
"team": {
"teamId": "aston_martin",
"teamName": "Aston Martin F1 Team",
"teamNationality": "Great Britain",
"firstAppeareance": 1959,
"constructorsChampionships": null,
"driversChampionships": null,
"url": "https://en.wikipedia.org/wiki/Aston_Martin_in_Formula_One"
},
"results": [
{
"race": {
"raceId": "china_2024",
"name": "Lenovo Chinese Grand Prix 2024",
"round": 5,
"date": "2024-04-21",
"circuit": {
"circuitId": "shangai",
"name": "Shangai International Circuit",
"country": "China",
"city": "Shangai",
"length": 5451,
"lapRecord": "1:32:238",
"firstParticipationYear": 2004,
"numberOfCorners": 16,
"fastestLapDriverId": "michael_schumacher",
"fastestLapTeamId": "ferrari",
"fastestLapYear": 2004
}
},
"result": {
"finishingPosition": 7,
"gridPosition": 3,
"raceTime": "+43.414",
"pointsObtained": 7,
"retired": null
},
"sprintResult": {
"finishingPosition": 17,
"gridPosition": 18,
"raceTime": "+42.998\t",
"pointsObtained": 0,
"retired": null
}
}
]
}| Field | Type | Description |
|---|---|---|
| api | string | The base API URL for the F1 Connect service. |
| url | string | The URL used to fetch the drivers data with query parameters for limit and offset. |
| limit | number | The number of results returned per request. |
| offset | number | The offset used for pagination, i.e., the starting point for the result set. |
| total | number | The total number of drivers available in the dataset. |
| season | string | The season of the championship. |
| championshipId | string | The championship id. |
| driver | object | The driver object. |
| name | string | The driver's first name. |
| surname | string | The driver's surname. |
| nationality | string | The driver's nationality. |
| birthday | string | The driver's birthdate 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. |
| teamNationality | string | The team nationality. |
| firstAppeareance | 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. |
| results | array | A list of results objects returned from the API. |
| race | object | The race object. |
| raceId | string | The race id. |
| name | string | The race name. |
| round | number | The race round. |
| date | string | The race date in YYYY-MM-DD format. |
| circuit | object | The circuit object. |
| circuitId | string | The circuit id. |
| name | string | The circuit name. |
| country | string | The circuit country. |
| city | string | The circuit city. |
| length | number | The circuit length in kilometers. |
| lapRecord | string | The lap record for the circuit. |
| firstParticipationYear | number | The year the circuit first hosted a Grand Prix. |
| numberOfCorners | 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. |
| result | object | The result object. |
| finishingPosition | number | The finishing position of the driver. |
| gridPosition | number | The grid position of the driver. |
| raceTime | string | The race time of the driver. |
| pointsObtained | number | The points obtained by the driver. |
| retired | boolean | Whether the driver retired or not. |
| sprintResult | object | The sprint result object. |
| finishingPosition | number | The finishing position of the driver. |
| gridPosition | number | The grid position of the driver. |
| raceTime | string | The race time of the driver. |
| pointsObtained | number | The points obtained by the driver. |
| retired | boolean | Whether the driver retired or not. |
| sprintResult | object | The sprint result object. |
| finishingPosition | number | The finishing position of the driver. |
| gridPosition | number | The grid position of the driver. |
| raceTime | string | The race time of the driver. |
| pointsObtained | number | The points obtained by the driver. |
| retired | boolean | Whether the driver retired or not. |
| Param | Default | Data |
|---|---|---|
| limit | 30 | Number of records returned per request. |
| offset | 0 | Number of records skipped before starting to fetch. |
| Status | Description |
|---|---|
| 200 | Successful request |
| 404 | Resource not found |
| 500 | Internal server error |