Season Service

Season Service

The Season service provides access to season schedules, race guides, and spectator session information.

const seasonService = iracing.season;

Methods

list(params)

Get a list of seasons for a given year and quarter.

Details

Returns: Promise<SeasonListResponse>

Parameters:

• seasonYear: number (required) - The season year
• seasonQuarter: number (required) - The season quarter (1-4)

Description: Returns all seasons for the specified year and quarter.

Example

const seasons = await iracing.season.list({
  seasonYear: 2024,
  seasonQuarter: 3
});

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

---

raceGuide(params?)

Get the race guide showing upcoming sessions.

Details

Returns: Promise<SeasonRaceGuideResponse>

Parameters:

• from?: string - Start time (ISO format)
• includeEndAfterFrom?: boolean - Include sessions that end after the from time

Description: Returns the race guide with upcoming race sessions and their schedules.

Example

// Get current race guide
const guide = await iracing.season.raceGuide();

// Get race guide from a specific time
const futureGuide = await iracing.season.raceGuide({
  from: '2024-06-01T00:00:00Z',
  includeEndAfterFrom: true
});

guide.sessions.forEach(session => {
  console.log(`${session.seriesName} - ${session.startDate}`);
});

---

spectatorSubsessionids(params?)

Get subsession IDs available for spectating.

Details

Returns: Promise<SeasonSpectatorSubsessionidsResponse>

Parameters:

• eventTypes?: number[] - Filter by event types

Description: Returns subsession IDs that are currently available for spectating.

Example

const spectatorSessions = await iracing.season.spectatorSubsessionids();

console.log('Available for spectating:', spectatorSessions);

---

spectatorSubsessionidsDetail(params?)

Get detailed spectator subsession information.

Details

Returns: Promise<SeasonSpectatorSubsessionidsDetailResponse>

Parameters:

• eventTypes?: number[] - Filter by event types
• seasonIds?: number[] - Filter by season IDs

Description: Returns detailed information about subsessions available for spectating, including series and track data.

Example

const details = await iracing.season.spectatorSubsessionidsDetail({
  seasonIds: [3456, 7890]
});

details.forEach(session => {
  console.log(`${session.seriesName} at ${session.trackName}`);
});

Common Use Cases

Find Available Races

async function findUpcomingRaces(categoryId?: number) {
  const guide = await iracing.season.raceGuide({
    includeEndAfterFrom: true
  });

  return guide.sessions.filter(session =>
    !categoryId || session.categoryId === categoryId
  );
}

See Also

• Series Service - Series details and schedules
• Results Service - Season results
• Stats Service - Season standings
• Services Overview - All available services