Series Service

Series Service

The Series service provides access to series information, assets, seasons, and schedules.

const seriesService = iracing.series;

Methods

get()

Get all series.

Details

Returns: Promise<SeriesGetResponse>

Parameters: None

Description: Returns information about all series available in iRacing.

Example

const series = await iracing.series.get();

series.forEach(s => {
  console.log(`${s.seriesName} (ID: ${s.seriesId})`);
  console.log(`  Category: ${s.categoryName}`);
});

---

assets()

Get series asset information.

Details

Returns: Promise<SeriesAssetsResponse>

Parameters: None

Description: Returns URLs for series images, logos, and other visual assets.

Example

const assets = await iracing.series.assets();

Object.entries(assets).forEach(([seriesId, asset]) => {
  console.log(`Series ${seriesId}: ${asset.logo}`);
});

---

pastSeasons(params)

Get past seasons for a series.

Details

Returns: Promise<SeriesPastSeasonsResponse>

Parameters:

• seriesId: number (required) - The series ID

Description: Returns historical season data for a specific series.

Example

const pastSeasons = await iracing.series.pastSeasons({
  seriesId: 234
});

pastSeasons.forEach(season => {
  console.log(`${season.seasonYear}S${season.seasonQuarter}: ${season.seasonName}`);
});

---

seasons(params?)

Get current season details.

Details

Returns: Promise<SeriesSeasonsResponse>

Parameters:

• includeSeries?: boolean - Include full series details
• seasonYear?: number - Filter by year
• seasonQuarter?: number - Filter by quarter (1-4)

Description: Returns current season information, optionally including full series details.

Example

const seasons = await iracing.series.seasons({
  includeSeries: true,
  seasonYear: 2024,
  seasonQuarter: 3
});

seasons.forEach(season => {
  console.log(`${season.seasonName}`);
});

---

seasonList(params?)

Get a list of seasons.

Details

Returns: Promise<SeriesSeasonListResponse>

Parameters:

• includeSeries?: boolean - Include full series details
• seasonYear?: number - Filter by year
• seasonQuarter?: number - Filter by quarter (1-4)

Description: Returns a list of seasons with optional filtering.

Example

const seasonList = await iracing.series.seasonList({
  seasonYear: 2024,
  seasonQuarter: 3
});

seasonList.forEach(season => {
  console.log(`${season.seasonName} (ID: ${season.seasonId})`);
});

---

seasonSchedule(params)

Get the race schedule for a season.

Details

Returns: Promise<SeriesSeasonScheduleResponse>

Parameters:

• seasonId: number (required) - The season ID

Description: Returns the complete race schedule for a specific season, including tracks, dates, and race configurations.

Example

const schedule = await iracing.series.seasonSchedule({
  seasonId: 3456
});

schedule.forEach(week => {
  console.log(`Week ${week.raceWeekNum}: ${week.trackName}`);
});

---

statsSeries()

Get series statistics data.

Details

Returns: Promise<SeriesStatsSeriesResponse>

Parameters: None

Description: Returns statistical data about series including participation counts and popularity metrics.

Example

const statsSeries = await iracing.series.statsSeries();

statsSeries.forEach(s => {
  console.log(`${s.seriesName}: ${s.averageParticipation} avg participants`);
});

Tip

Series and asset data is relatively static. Consider implementing your own caching strategy for optimal performance. Response caching is coming in a future release.

Common Use Cases

Build a Series Directory

async function getSeriesDirectory() {
  const [series, assets] = await Promise.all([
    iracing.series.get(),
    iracing.series.assets(),
  ]);

  return series.map(s => ({
    ...s,
    assets: assets[s.seriesId],
  }));
}

Get Full Season Schedule

async function getFullSchedule(seriesId: number) {
  const pastSeasons = await iracing.series.pastSeasons({ seriesId });
  const currentSeason = pastSeasons[pastSeasons.length - 1];

  const schedule = await iracing.series.seasonSchedule({
    seasonId: currentSeason.seasonId
  });

  return schedule;
}

See Also

• Season Service - Season list and race guide
• Results Service - Season results
• Track Service - Track information
• Services Overview - All available services