GET Race Results by Season and Driver
This endpoint returns the race results for a provided season ID and player ID. The endpoint includes all the stages, fixtures, lineups and lineup details for a season and driver.
https://api.sportmonks.com/v3/motorsport/results/seasons/SEASON_ID/drivers/DRIVER_ID{
"data": [
{
"id": 77476128,
"sport_id": 2,
"league_id": 3468,
"season_id": 25273,
"type_id": 9724,
"name": "Formula 1 Etihad Airways Abu Dhabi Grand Prix",
"sort_order": 24,
"finished": true,
"is_current": false,
"starting_at": "2025-12-05",
"ending_at": "2025-12-07",
"games_in_current_week": false,
"tie_breaker_rule_id": 573,
"fixtures": [
{
"id": 19408487,
"sport_id": 2,
"league_id": 3468,
"season_id": 25273,
"stage_id": 77476128,
"group_id": null,
"aggregate_id": null,
"round_id": null,
"state_id": 5,
"venue_id": 343598,
"name": "Race",
"starting_at": "2025-12-07 13:00:00",
"result_info": null,
"leg": "1/1",
"details": null,
"length": null,
"placeholder": false,
"has_odds": false,
"has_premium_odds": false,
"starting_at_timestamp": 1765112400,
"lineups": [
{
"id": 14671697693,
"sport_id": 2,
"fixture_id": 19408487,
"player_id": 37920802,
"team_id": 276191,
"position_id": 9730,
"type_id": 11,
"grid_position": 2,
"driver_name": "Lando Norris",
"driver_number": 4,
"details": [
{
"id": 1816685645,
"fixture_id": 19408487,
"player_id": 37920802,
"team_id": 276191,
"lineup_id": 14671697693,
"type_id": 9711,
"data": {
"position": 3
}
},
// More results...
]
}
]
},
// More fixtures...
]
},
// More stages...
]
}Stages
id
Refers to the unique id of the stage
integer
sport_id
Refers to the sport of the stage
integer
league_id
Refers to the league related to the stage
integer
season_id
Refers to the season related to the stage
integer
type_id
Indicates what the stage type is
integer
name
Returns the name of the stage
string
sort_order
Returns the order of the stage
integer
finished
Indicates if the stage is finished or not
boolean
is_current
Indicates if the stage is the current stage or not
boolean
starting_at
The starting date of the stage
string
ending_at
The end date of the stage
string
games_in_current_week
Not used in the Motorsport API
boolean
tie_breaker_rule_id
Refers to the tie breaker rule related to the stage - N/A for the Motorsport API
integer
Fixtures
id
Refers the unique id of the fixture
integer
sport_id
Refers to the sport of the fixture
integer
league_id
Refers to the league the fixture is held in
integer
season_id
Refers to the seasons the fixture is held in
integer
stage_id
Refers to the stage (e.g. race weekend) the fixture is held in
integer
group_id
Not used in the Motorsport API
null
aggregate_id
Not used in the Motorsport API
null
round_id
Not used in the Motorsport API
null
state_id
Refers to the state the fixture is currently in
integer
venue_id
Refers to the venue (track) the fixture is held at
integer
name
Represents the name of the fixture
string
starting_at
String representing the start date and time
date
result_info
Represents the final result info
string
leg
Represents the stage of the fixture, e.g. 2/3 for Practice 2 (of 3) or 3/3 for Qualification 3. Note: Returns 1/1 for Practice 1 if the other practice sessions are replaced by the sprint sessions.
string
details
Represents details about the fixture
string
length
Planned length of the session in minutes (practice and qualification sessions); Total amount of laps (race sessions)
integer
placeholder
Represents if the fixture is a placeholder
boolean
has_odds
Not used in the Motorsport API
boolean
has_premium_odds
Not used in the Motorsport API
boolean
starting_at_timestamp
Integer representing the starting Unix timestamp (in seconds since Unix Epoch)
integer
api_token
YES
Your unique API token
include
NO
Enrich the API with more data by using includes
select
NO
Select specific fields on the base entity
filters
NO
Filter the API response on multiple related entities. There are static filters and dynamic filters.
Please find the possibilities in the Static and Dynamic Filter tab.
Static filters are always the same and filter in one specific way without any custom options. Each static filter is listed below and has a description of how it filters. For more information, please look at our Filters page.
Not applicable for this endpoint.
Pagination
YES
Include depth
You can use a total of 0 nested includes on this endpoint
Include options
None
Related Entities:
Get an overview and explanation of all the fields returned in the API response. The related entities for the Results endpoints are:
Code Example
require "uri"
require "net/http"
url = URI("https://api.sportmonks.com/v3/motorsport/results/seasons/25273/drivers/37920802?api_token={your_token}")
https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true
request = Net::HTTP::Get.new(url)
response = https.request(request)
puts response.read_body
import http.client
conn = http.client.HTTPSConnection("api.sportmonks.com")
payload = ''
headers = {}
conn.request("GET", "/v3/motorsport/results/seasons/25273/drivers/37920802?api_token={your_token}", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))Last updated
Was this helpful?