This endpoint retrieves details about a driver and his race results. Based on the provided driverId and the current season.
{
"api": "https://f1connectapi.vercel.app",
"url": "https://f1connectapi.vercel.app/api/current/drivers?limit=1",
"offset": 0,
"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": "bahrein_2024",
"name": "Gulf Air Bahrain Grand Prix 2024",
"round": 1,
"date": "2024-03-02",
"circuit": {
"circuitId": "bahrein",
"name": "Bahrein International Circuit",
"country": "Bahrein",
"city": "Sakhir",
"length": 5412,
"lapRecord": "1:31:447",
"firstParticipationYear": 2004,
"numberOfCorners": 15,
"fastestLapDriverId": "de_la_rosa",
"fastestLapTeamId": "mclaren",
"fastestLapYear": 2005
}
},
"result": {
"finishingPosition": 9,
"gridPosition": 6,
"raceTime": "+1:14.887",
"pointsObtained": 2,
"retired": null
},
"sprintResult": 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 | number | The season of the championship. |
| championshipId | string | The championship id. |
| driver | object | The driver object. |
| driverId | string | A unique identifier for the driver. |
| 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 country. |
| firstAppeareance | string | null | The year the team first appeared in the championship. |
| constructorsChampionships | string | null | The number of constructors championships the team has won. |
| driversChampionships | string | null | The number of drivers championships the team has won. |
| results | array | Array with the results of the races. |
| 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. |
| url | string | A URL to the Wikipedia page of the circuit. |
| result | object | Result of the driver in each race. |
| finishingPosition | number | The finishing position of the driver in the race. |
| gridPosition | number | The grid position of the driver in the race. |
| raceTime | number | The time of the driver in the race. |
| pointsObtained | number | The points obtained by the driver in the race. |
| retired | boolean | Whether the driver retired or not. |
| sprintResult | object | null | Result of the driver in the sprint race. |
| 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 |