iRacing /data API Schema Documentation

Endpoint: `/data/results/search_hosted`

Note from iRacing

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.

Parameters

Parameter Type Required
car_id number
track_id number
team_id number
host_cust_id number
league_id number
league_season_id number
category_ids numbers
start_range_begin string
start_range_end string
finish_range_begin string
finish_range_end string
cust_id number
session_name string

Response Schema

Field Type Optional
data chunks of array of [data]
type string

Field: data

This field is an array of:

Field Type Optional
cars array of [cars]
created string
cust_id integer
driver_changes boolean
end_time string
event_average_lap integer
event_best_lap_time integer
event_laps_complete integer
finish_position integer
finish_position_in_class integer
heat_race boolean
host Host
incidents integer
laps_complete integer
laps_led integer
league_id integer
league_season_id integer
license_category string
license_category_id integer
num_caution_laps integer
num_cautions integer
num_drivers integer
num_lead_changes integer
practice_length integer
private_session_id integer
qualify_laps integer
qualify_length integer
race_laps integer
race_length integer
session_id integer
session_name string
start_time string
starting_position integer
starting_position_in_class integer
subsession_id integer
track Track
winner_ai boolean
winner_group_id integer
winner_name string

Field: data.cars

This field is an array of:

Field Type Optional
car_class_id integer
car_class_name string
car_class_short_name string
car_id integer
car_name string
car_name_abbreviated string

Generated by irschema v0.3.4


Last Updated: March 24, 2026 at 09:12 PM
if you find this useful, you can always Buy Me A Coffee