Categories

Coverage
Stage Types
Probabilities
Lap Speed

Integration
Stage & Driver Statuses
Standings

.

Coverage

What races are covered in the IndyCar API?

The entire IndyCar Championship. For a more detailed breakdown, reference our Coverage Matrix.

Is it updated in real-time?

No. Results for practices, qualifications, and races are added after the events are complete.

Does this API include Qualifying and Practice sessions?

Yes, qualifying and practice sessions are updated post-event.

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?

Date values are presented in the ISO 8601 standard format.

Timestamp fields are in UTC. These could include scheduled start times or play-by-play event timestamps. Examples: scheduled="2024-02-11T23:30:00+00:00", created_at="2024-02-11T23:43:20+00:00"

Date-only fields reflect local league convention and are not UTC-adjusted. These could include season start dates and birth dates. Examples: start_date="2024-08-16", date_of_birth="1984-09-22"

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?

sport
season
event
practice
qualifying
qualifying_part
race
lap

Stage & Driver Statuses

What are the valid statuses of a race or stage?

Cancelled - The stage is cancelled and will not be taking place
Closed - The stage is over and we have validated the results
Completed - The stage is over, but we have not finished data collection and validation
Finished - The stage is over
Not Started - The stage has not begun
Preliminary - The stage is about to begin
Running - The stage is currently in progress

What are the valid result statuses?

Finished
Out

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.

Standings

How do I see the Championship points table?

Use the Stage Summary endpoint and a season stage ID as the parameter. The competitors node lists competitors, ranked with points, position, victories, races, races with points, and podiums.

<competitors>
    <competitor id="sr:competitor:677077" name="Palou, Alex" gender="male" nationality="Spain" country_code="ESP">
        <result points="656" car_number="10" position="1" victories="5" races="17" races_with_points="17" pole_positions="2" podiums="9" top5="13" top10="17"/>
    </competitor>
    <competitor id="sr:competitor:320091" name="Dixon, Scott" gender="male" nationality="New Zealand" country_code="NZL">
        <result points="578" car_number="9" position="2" victories="3" races="17" races_with_points="17" pole_positions="0" podiums="5" top5="11" top10="16"/>
    </competitor>
    <competitor id="sr:competitor:730391" name="McLaughlin, Scott" gender="male" nationality="New Zealand" country_code="NZL">
        <result points="488" car_number="3" position="3" victories="1" races="17" races_with_points="17" pole_positions="1" podiums="4" top5="7" top10="14"/>
    </competitor>

Lap Speed

What unit of measurement is used for lap speed?

Beginning in 2023, the unit of measurement is miles per hour. In previous seasons the data is kilometers per hour.