API Data

Content Block Missing

Label	Link	Expires (s)
assets	data/car/assets	900
['image paths are relative to https://images-static.iracing.com/']
get	data/car/get	900

Content Block Missing

Label	Link	Expires (s)	Parameters
get	data/carclass/get	900

Content Block Missing

Label	Link	Expires (s)
categories	data/constants/categories	900
Constant; returned directly as an array of objects
divisions	data/constants/divisions	900
Constant; returned directly as an array of objects
event_types	data/constants/event_types	900
Constant; returned directly as an array of objects

Content Block Missing

Label	Link	Expires (s)
oval	data/driver_stats_by_category/oval	900
sports_car	data/driver_stats_by_category/sports_car	900
formula_car	data/driver_stats_by_category/formula_car	900
road	data/driver_stats_by_category/road	900
dirt_oval	data/driver_stats_by_category/dirt_oval	900
dirt_road	data/driver_stats_by_category/dirt_road	900

Content Block Missing

Label

Link

Expires (s)

Parameters

combined_sessions

data/hosted/combined_sessions

60

Label	Type	Note
package_id	number	If set, return only sessions using this car or track package ID.

Sessions that can be joined as a driver or spectator, and also includes non-league pending sessions for the user.

sessions

data/hosted/sessions

60

Sessions that can be joined as a driver. Without spectator and non-league pending sessions for the user.

Content Block Missing

Label

Link

Expires (s)

Parameters

cust_league_sessions

data/league/cust_league_sessions

900

Label	Type	Note
mine	boolean	If true, return only sessions created by this user.
package_id	number	If set, return only sessions using this car or track package ID.

directory

data/league/directory

900

Label	Type	Note
search	string	Will search against league name, description, owner, and league ID.
tag	string	One or more tags, comma-separated.
restrict_to_member	boolean	If true include only leagues for which customer is a member.
restrict_to_recruiting	boolean	If true include only leagues which are recruiting.
restrict_to_friends	boolean	If true include only leagues owned by a friend.
restrict_to_watched	boolean	If true include only leagues owned by a watched member.
minimum_roster_count	number	If set include leagues with at least this number of members.
maximum_roster_count	number	If set include leagues with no more than this number of members.
lowerbound	number	First row of results to return. Defaults to 1.
upperbound	number	Last row of results to return. Defaults to lowerbound + 39.
sort	string	One of relevance, leaguename, displayname, rostercount. displayname is owners's name. Defaults to relevance.
order	string	One of asc or desc. Defaults to asc.

get

data/league/get

900

Label	Type	Note
league_id	number
include_licenses	boolean	For faster responses, only request when necessary.

get_points_systems

data/league/get_points_systems

900

Label	Type	Note
league_id	number
season_id	number	If included and the season is using custom points (points_system_id:2) then the custom points option is included in the returned list. Otherwise the custom points option is not returned.

membership

data/league/membership

900

Label	Type	Note
cust_id	number	If different from the authenticated member, the following resrictions apply: - Caller cannot be on requested customer's block list or an empty list will result; - Requested customer cannot have their online activity prefrence set to hidden or an empty list will result; - Only leagues for which the requested customer is an admin and the league roster is not private are returned.
include_league	boolean

roster

data/league/roster

900

Label	Type	Note
league_id	number
include_licenses	boolean	For faster responses, only request when necessary.

seasons

data/league/seasons

900

Label	Type	Note
league_id	number
retired	boolean	If true include seasons which are no longer active.

season_standings

data/league/season_standings

900

Label	Type	Note
league_id	number
season_id	number
car_class_id	number
car_id	number	If car_class_id is included then the standings are for the car in that car class, otherwise they are for the car across car classes.

season_sessions

data/league/season_sessions

900

Label	Type	Note
league_id	number
season_id	number
results_only	boolean	If true include only sessions for which results are available.

Content Block Missing

Label

Link

Expires (s)

Parameters

club_history

data/lookup/club_history

900

Label	Type	Note
season_year	number
season_quarter	number

Returns an earlier history if requested quarter does not have a club history.

countries

data/lookup/countries

900

drivers

data/lookup/drivers

900

Label	Type	Note
search_term	string	A cust_id or partial name for which to search.
league_id	number	Narrow the search to the roster of the given league.

get

data/lookup/get

900

?weather=weather_wind_speed_units&weather=weather_wind_speed_max&weather=weather_wind_speed_min&licenselevels=licenselevels

licenses

data/lookup/licenses

900

Content Block Missing

Label

Link

Expires (s)

Parameters

awards

data/member/awards

900

Label	Type	Note
cust_id	number	Defaults to the authenticated member.

chart_data

data/member/chart_data

900

Label	Type	Note
cust_id	number	Defaults to the authenticated member.
category_id	number	1 - Oval; 2 - Road; 3 - Dirt oval; 4 - Dirt road
chart_type	number	1 - iRating; 2 - TT Rating; 3 - License/SR

get

data/member/get

900

Label	Type	Note
cust_ids	numbers	?cust_ids=2,3,4
include_licenses	boolean

info

data/member/info

900

Always the authenticated member.

participation_credits

data/member/participation_credits

900

Always the authenticated member.

profile

data/member/profile

900

Label	Type	Note
cust_id	number	Defaults to the authenticated member.

Content Block Missing

Label

Link

Expires (s)

Parameters

get

data/results/get

900

Label	Type	Note
subsession_id	number
include_licenses	boolean

Get the results of a subsession, if authorized to view them. series_logo image paths are relative to https://images-static.iracing.com/img/logos/series/

event_log

data/results/event_log

900

Label	Type	Note
subsession_id	number
simsession_number	number	The main event is 0; the preceding event is -1, and so on.

lap_chart_data

data/results/lap_chart_data

900

Label	Type	Note
subsession_id	number
simsession_number	number	The main event is 0; the preceding event is -1, and so on.

lap_data

data/results/lap_data

900

Label	Type	Note
subsession_id	number
simsession_number	number	The main event is 0; the preceding event is -1, and so on.
cust_id	number	Required if the subsession was a single-driver event. Optional for team events. If omitted for a team event then the laps driven by all the team's drivers will be included.
team_id	number	Required if the subsession was a team event.

search_hosted

data/results/search_hosted

900

Label	Type	Note
start_range_begin	string	Session start times. ISO-8601 UTC time zero offset: "2022-04-01T15:45Z".
start_range_end	string	ISO-8601 UTC time zero offset: "2022-04-01T15:45Z". Exclusive. May be omitted if start_range_begin is less than 90 days in the past.
finish_range_begin	string	Session finish times. ISO-8601 UTC time zero offset: "2022-04-01T15:45Z".
finish_range_end	string	ISO-8601 UTC time zero offset: "2022-04-01T15:45Z". Exclusive. May be omitted if finish_range_begin is less than 90 days in the past.
cust_id	number	The participant's customer ID. Ignored if team_id is supplied.
team_id	number	The team ID to search for. Takes priority over cust_id if both are supplied.
host_cust_id	number	The host's customer ID.
session_name	string	Part or all of the session's name.
league_id	number	Include only results for the league with this ID.
league_season_id	number	Include only results for the league season with this ID.
car_id	number	One of the cars used by the session.
track_id	number	The ID of the track used by the session.
category_ids	numbers	Track categories to include in the search. Defaults to all. ?category_ids=1,2,3,4

Hosted and league sessions. Maximum time frame of 90 days. Results split into one or more files with chunks of results. For scraping results the most effective approach is to keep track of the maximum end_time found during a search then make the subsequent call using that date/time as the finish_range_begin and skip any subsessions that are duplicated. Results are ordered by subsessionid which is a proxy for start time. Requires one of: start_range_begin, finish_range_begin. Requires one of: cust_id, team_id, host_cust_id, session_name.

search_series

data/results/search_series

900

Label	Type	Note
season_year	number	Required when using season_quarter.
season_quarter	number	Required when using season_year.
start_range_begin	string	Session start times. ISO-8601 UTC time zero offset: "2022-04-01T15:45Z".
start_range_end	string	ISO-8601 UTC time zero offset: "2022-04-01T15:45Z". Exclusive. May be omitted if start_range_begin is less than 90 days in the past.
finish_range_begin	string	Session finish times. ISO-8601 UTC time zero offset: "2022-04-01T15:45Z".
finish_range_end	string	ISO-8601 UTC time zero offset: "2022-04-01T15:45Z". Exclusive. May be omitted if finish_range_begin is less than 90 days in the past.
cust_id	number	Include only sessions in which this customer participated. Ignored if team_id is supplied.
team_id	number	Include only sessions in which this team participated. Takes priority over cust_id if both are supplied.
series_id	number	Include only sessions for series with this ID.
race_week_num	number	Include only sessions with this race week number.
official_only	boolean	If true, include only sessions earning championship points. Defaults to all.
event_types	numbers	Types of events to include in the search. Defaults to all. ?event_types=2,3,4,5
category_ids	numbers	License categories to include in the search. Defaults to all. ?category_ids=1,2,3,4

Official series. Maximum time frame of 90 days. Results split into one or more files with chunks of results. For scraping results the most effective approach is to keep track of the maximum end_time found during a search then make the subsequent call using that date/time as the finish_range_begin and skip any subsessions that are duplicated. Results are ordered by subsessionid which is a proxy for start time but groups together multiple splits of a series when multiple series launch sessions at the same time. Requires at least one of: season_year and season_quarter, start_range_begin, finish_range_begin.

season_results

data/results/season_results

900

Label	Type	Note
season_id	number
event_type	number	Retrict to one event type: 2 - Practice; 3 - Qualify; 4 - Time Trial; 5 - Race
race_week_num	number	The first race week of a season is 0.

Content Block Missing

Label

Link

Expires (s)

Parameters

list

data/season/list

900

Label	Type	Note
season_year	number
season_quarter	number

race_guide

data/season/race_guide

60

Label	Type	Note
from	string	ISO-8601 offset format. Defaults to the current time. Include sessions with start times up to 3 hours after this time. Times in the past will be rewritten to the current time.
include_end_after_from	boolean	Include sessions which start before 'from' but end after.

spectator_subsessionids

data/season/spectator_subsessionids

60

Label	Type	Note
event_types	numbers	Types of events to include in the search. Defaults to all. ?event_types=2,3,4,5

spectator_subsessionids_detail

data/season/spectator_subsessionids_detail

60

Label	Type	Note
event_types	numbers	Types of events to include in the search. Defaults to all. ?event_types=2,3,4,5
season_ids	numbers	Seasons to include in the search. Defaults to all. ?season_ids=513,937

Content Block Missing

Label

Link

Expires (s)

Parameters

assets

data/series/assets

900

['image paths are relative to https://images-static.iracing.com/']

get

data/series/get

900

past_seasons

data/series/past_seasons

900

Label	Type	Note
series_id	number

Get all seasons for a series. Filter list by official:true for seasons with standings.

seasons

data/series/seasons

900

Label	Type	Note
include_series	boolean

stats_series

data/series/stats_series

900

To get series and seasons for which standings should be available, filter the list by official: true.

Content Block Missing

Label

Link

Expires (s)

Parameters

member_bests

data/stats/member_bests

900

Label	Type	Note
cust_id	number	Defaults to the authenticated member.
car_id	number	First call should exclude car_id; use cars_driven list in return for subsequent calls.

member_career

data/stats/member_career

900

Label	Type	Note
cust_id	number	Defaults to the authenticated member.

member_division

data/stats/member_division

900

Label	Type	Note
season_id	number
event_type	number	The event type code for the division type: 4 - Time Trial; 5 - Race

Divisions are 0-based: 0 is Division 1, 10 is Rookie. See /data/constants/divisons for more information. Always for the authenticated member.

member_recap

data/stats/member_recap

900

Label	Type	Note
cust_id	number	Defaults to the authenticated member.
year	number	Season year; if not supplied the current calendar year (UTC) is used.
season	number	Season (quarter) within the year; if not supplied the recap will be fore the entire year.

member_recent_races

data/stats/member_recent_races

900

Label	Type	Note
cust_id	number	Defaults to the authenticated member.

member_summary

data/stats/member_summary

900

Label	Type	Note
cust_id	number	Defaults to the authenticated member.

member_yearly

data/stats/member_yearly

900

Label	Type	Note
cust_id	number	Defaults to the authenticated member.

season_driver_standings

data/stats/season_driver_standings

900

Label	Type	Note
season_id	number
car_class_id	number
club_id	number	Defaults to all (-1).
division	number	Divisions are 0-based: 0 is Division 1, 10 is Rookie. See /data/constants/divisons for more information. Defaults to all.
race_week_num	number	The first race week of a season is 0.

season_supersession_standings

data/stats/season_supersession_standings

900

Label	Type	Note
season_id	number
car_class_id	number
club_id	number	Defaults to all (-1).
division	number	Divisions are 0-based: 0 is Division 1, 10 is Rookie. See /data/constants/divisons for more information. Defaults to all.
race_week_num	number	The first race week of a season is 0.

season_team_standings

data/stats/season_team_standings

900

Label	Type	Note
season_id	number
car_class_id	number
race_week_num	number	The first race week of a season is 0.

season_tt_standings

data/stats/season_tt_standings

900

Label	Type	Note
season_id	number
car_class_id	number
club_id	number	Defaults to all (-1).
division	number	Divisions are 0-based: 0 is Division 1, 10 is Rookie. See /data/constants/divisons for more information. Defaults to all.
race_week_num	number	The first race week of a season is 0.

season_tt_results

data/stats/season_tt_results

900

Label	Type	Note
season_id	number
car_class_id	number
race_week_num	number	The first race week of a season is 0.
club_id	number	Defaults to all (-1).
division	number	Divisions are 0-based: 0 is Division 1, 10 is Rookie. See /data/constants/divisons for more information. Defaults to all.

season_qualify_results

data/stats/season_qualify_results

900

Label	Type	Note
season_id	number
car_class_id	number
race_week_num	number	The first race week of a season is 0.
club_id	number	Defaults to all (-1).
division	number	Divisions are 0-based: 0 is Division 1, 10 is Rookie. See /data/constants/divisons for more information. Defaults to all.

world_records

data/stats/world_records

900

Label	Type	Note
car_id	number
track_id	number
season_year	number	Limit best times to a given year.
season_quarter	number	Limit best times to a given quarter; only applicable when year is used.

Content Block Missing

Label

Link

Expires (s)

Parameters

get

data/team/get

900

Label	Type	Note
team_id	number
include_licenses	boolean	For faster responses, only request when necessary.

Content Block Missing

Label

Link

Expires (s)

Parameters

member_season_results

data/time_attack/member_season_results

900

Label	Type	Note
ta_comp_season_id	number

Results for the authenticated member, if any.

Content Block Missing

Label	Link	Expires (s)
assets	data/track/assets	900
['image paths are relative to https://images-static.iracing.com/']
get	data/track/get	900

This is the API

Car

Car Class

Constants

Driver Stats By Category

Hosted

League

Lookup

Member

Results

Season

Series

Stats

Team

Time Attack

Track