Docs
Coverage MatrixDocumentationRelease LogLog In

IndyCar Overview

Introduction

The IndyCar API provides schedules and post-race results for the entire IndyCar Series. All data is collected via Sportradar’s expert operators.

Select the IndyCar package in our Coverage Matrix for events and data offered.

This API uses a descending, stage-based structure. By changing the stage ID, you can retrieve information on a season, event, race, or any of the practice or qualifying stages.

Additional feeds provide complementary stats, including racer profiles and race win probabilities.

🗝️

Authentication is required for all API calls.

Stage Format

The IndyCar API uses generic stage implementation. The core of the API is built around the concept of stages. For example, an event contains the following stage types: practice, qualifying, and race. Each of those stages, in turn, have stages (except Practice which has no sub-stages). The IDs of each stage are usable in the URL path to request information about that particular stage. Qualifying stages contain sub-stages known as "Qualifying Parts". In the Race stages, the sub-stages are laps. You can use the lap stage ID in the URL to get specific lap details, including driver times, and position.

The IndyCar sport and seasons within it are stages as well. The sport stage consists of season stages for each annual season. Using the ID of a chosen season as a parameter in the Stage Summary endpoint you can "drill down" into each season. For example, using the 2018 season ID as a parameter in the Stage Summary endpoint, the sub-stages will be individual race events. From the race event, you can drill down into the practice, qualifying, race, and lap stages of a race using the same endpoint with different stage IDs.

The best way to "start" the navigation with the IndyCar API is using the Seasons endpoint. From there one can obtain the stage ID for the season required and use that as a parameter in the Stage Summary endpoint.

Stage TypeInformation IncludedSub-stages
SportInformation about the seasons included. Which is limited to the current and previous season only. Note probabilities do not return valid data on this stage.IndyCar seasons: 2017, 2018.
SeasonContains the season schedule, driver standings and statistics.Events on the IndyCar calendar for that season.
EventInformation about a single event, the competitors, the teams, and the circuit.Sessions (eg: Practice, Qualifying, Race)
PracticeCompetitors and results of practice such as fastest time etc.None
QualifyingInformation pertaining to the qualifying stage of the event including conditions, competitors, and overall qualifying results.Qualifying Parts
Qualifying PartInformation about the individual qualifying parts of the overall qualifying stage such as conditions, competitors, and results.None
RaceDetails of the race itself including the competitors, lap by lap, and overall results.Laps
LapSpecific details on individual laps such as driver positions, times, etc. Note probabilities do not return valid data on this stage.None.

API Map


Endpoint Descriptions

Competitor Merge Mappings - Provides the valid Sportradar Id in cases when two competitors have been merged into one.

Competitor Profile – Provides biographical information for a given driver. 

Deleted Stages - Provides all deleted stages within a given season.

Seasons - Provides a complete historical list of available seasons. This is the starting point for the IndyCar API. 

Stage Probabilities – Provides the outrights for each driver for a given race. 

Stage Schedule – Provides schedule information for a given stage. 

Stage Summary – Provides schedules and results information based on the stage provided (season, event, practice, qualifying, qualifying part, or race).


Data Retrieval Sample

To find the win probabilities for a given race:

  1. Call the Seasons endpoint and find the Stage Id for the current season
  2. Call the Stage Schedule using the 'season' Stage Id
  3. Locate the Stage Id for the upcoming race
  4. Call the Stage Probabilities using the 'race' Stage Id
  5. Within the results locate the win probability for each racer

The probability of a win for each racer is displayed.


Integration Links

OpenAPI Spec

Our IndyCar API is available via OpenAPI. Click below to view and/or download the spec.

IndyCar v2 OpenAPI

Postman Workspace

Our entire Media APIs are available on Postman. Click the link above to be taken directly to our Indycar API collection.

Feel free to follow and/or fork any collections to receive updates.

Schema Download

Open the zip file below to access our entire Indycar API XSD schema.

Indycar v2 Schema