Frequently asked questions for Rally v2
Click on the categories below or browse questions on the right panel.
Categories
.
Coverage
What races are covered in the Rally API?
For a detailed breakdown of races covered, reference our Coverage Matrix.
Is it updated in real-time?
No. Results for practices, qualifications, and races are added after the events are complete.
Integration
How do I retrieve information about an individual driver?
Use the Competitor Profile endpoint with the required driver's competitor ID. The best place to get the driver's competitor ID is the Stage Summary endpoint, using the season stage ID.
How do I know what 'stage' I am currently looking at?
Each stage has a stage element. The stage element has an attribute type which displays the stage type. The valid stage types are listed here.
<stage id="sr:stage:686254" description="Australian Grand Prix 2021" scheduled="2021-11-19T01:30:00+00:00"
scheduled_end="2021-11-21T08:00:00+00:00" type="event" status="Cancelled" single_event="false">
"stages": [
{
"id": "sr:stage:686254",
"description": "Australian Grand Prix 2021",
"scheduled": "2021-11-19T01:30:00+00:00",
"scheduled_end": "2021-11-21T08:00:00+00:00",
"type": "event",
"status": "Cancelled",
"single_event": false,
"venue": {
"id": "sr:venue:1011",
"name": "Melbourne Grand Prix Circuit",
"city": "Melbourne",
"country": "Australia",
"coordinates": "-37.840089,144.953527",
"country_code": "AUS",
"length": 5303,
"url_official": "http://www.grandprix.com.au",
"debut": 1996,
"curves_left": 6,
"curves_right": 10,
"laps": 58,
"timezone": "Australia/Melbourne"
},
"stages": [
{
"id": "sr:stage:686256",
"description": "Practice 1",
"scheduled": "2021-11-19T01:30:00+00:00",
"scheduled_end": "2021-11-19T02:30:00+00:00",
"type": "practice",
"single_event": false
},
{
"id": "sr:stage:686258",
"description": "Practice 2",
"scheduled": "2021-11-19T05:00:00+00:00",
"scheduled_end": "2021-11-19T06:00:00+00:00",
"type": "practice",
"single_event": false
},
{
"id": "sr:stage:686260",
"description": "Practice 3",
"scheduled": "2021-11-20T03:00:00+00:00",
"scheduled_end": "2021-11-20T04:00:00+00:00",
"type": "practice",
"single_event": false
},
{
"id": "sr:stage:686262",
"description": "Qualification",
"scheduled": "2021-11-20T06:00:00+00:00",
"scheduled_end": "2021-11-20T07:00:00+00:00",
"type": "qualifying",
"single_event": false,
"stages": [
{
"id": "sr:stage:686264",
"description": "Q1",
"scheduled": "2021-03-20T00:00:00+00:00",
"scheduled_end": "2021-03-20T00:00:00+00:00",
"type": "qualifying_part",
"single_event": false
},
{
"id": "sr:stage:686266",
"description": "Q2",
"scheduled": "2021-03-20T00:00:00+00:00",
"scheduled_end": "2021-03-20T00:00:00+00:00",
"type": "qualifying_part",
"single_event": false
},
{
"id": "sr:stage:686268",
"description": "Q3",
"scheduled": "2021-03-20T00:00:00+00:00",
"scheduled_end": "2021-03-20T00:00:00+00:00",
"type": "qualifying_part",
"single_event": false
}
]
},
{
"id": "sr:stage:686270",
"description": "Race",
"scheduled": "2021-11-21T06:00:00+00:00",
"scheduled_end": "2021-11-21T08:00:00+00:00",
"type": "race",
"single_event": false
}
]
},
What format are date fields presented in?
When we present date only values we present these in the ISO 8601 standard format.
ex: 2013-04-03
We use these for attributes that have date and no time (such as birthdate). For more information: https://en.wikipedia.org/wiki/ISO_8601
What format are the date/time fields presented in?
All of our Date/Time attributes are in UTC, presented in the ISO 8601 standard format.
ex: 2013-04-03T18:15:00+00:00
For more information: https://en.wikipedia.org/wiki/ISO_8601
How do I locate the TTL (Time to Live)/cache on an API endpoint?
The cache (in seconds) can be accessed in the returned header information on each RESTful API call, under cache-control.
ex. cache-control: max-age=1, public, s-maxage=1 or
cache-control: public, must-revalidate, max-age=120
Stage Types
What are the valid stage types?
sportseasoneventrace
Race Statuses
What are the valid statuses of a race or stage?
Cancelled- The stage is cancelled and will not be taking placeClosed- The stage is over and we have validated the resultsCompleted- The stage is over, but we have not finished data collection and validationFinished- The stage is overNot Started- The stage has not begunPreliminary- The stage is about to beginRunning- The stage is currently in progress
Probabilities
How do I get probabilities for the entire Championship? Or only one race?
You can use season, event, and race stage IDs as parameters for the Stage Probabilities endpoint.
Probabilities are available for the individual driver to win the season, a single event, and race stage. Probabilities are not available on the Sport, Practice, Qualifying, or Lap stages.
More questions?
Reach out to [email protected] for further assistance.