Stats Service

Stats Service

The Stats service provides comprehensive access to member statistics, season standings, time trial results, qualifying results, and world records.

const statsService = iracing.stats;

Member Statistics

memberBests(params?)

Get a member’s personal best lap times.

Details

Returns: Promise<StatsMemberBestsResponse>

Parameters:

• custId?: number - Customer ID (defaults to authenticated user)
• carId?: number - Filter to a specific car

Description: Returns the member’s personal best lap times across all tracks.

Example

// Get your own bests
const myBests = await iracing.stats.memberBests();

// Get bests for a specific car
const carBests = await iracing.stats.memberBests({
  carId: 123
});

// Get another member's bests
const otherBests = await iracing.stats.memberBests({
  custId: 123456
});

---

memberCareer(params?)

Get a member’s career statistics.

Details

Returns: Promise<StatsMemberCareerResponse>

Parameters:

• custId?: number - Customer ID (defaults to authenticated user)

Description: Returns career-wide statistics including starts, wins, top fives, and more.

Example

const career = await iracing.stats.memberCareer({
  custId: 123456
});

career.forEach(category => {
  console.log(`${category.categoryName}:`);
  console.log(`  Starts: ${category.starts}`);
  console.log(`  Wins: ${category.wins}`);
  console.log(`  Top 5s: ${category.top5}`);
});

---

memberDivision(params)

Get division statistics for a member.

Details

Returns: Promise<StatsMemberDivisionResponse>

Parameters:

• seasonId: number (required) - The season ID
• eventType: number (required) - The event type

Description: Returns the member’s division-level statistics for a specific season and event type.

Example

const division = await iracing.stats.memberDivision({
  seasonId: 3456,
  eventType: 5  // Race
});

console.log('Division stats:', division);

---

memberRecap(params?)

Get a member’s season recap.

Details

Returns: Promise<StatsMemberRecapResponse>

Parameters:

• custId?: number - Customer ID (defaults to authenticated user)
• year?: number - Filter by year
• season?: number - Filter by season quarter (1-4)

Description: Returns a recap of the member’s performance for a season or year.

Example

const recap = await iracing.stats.memberRecap({
  custId: 123456,
  year: 2024,
  season: 3
});

console.log('Season recap:', recap);

---

memberRecentRaces(params?)

Get a member’s recent race results.

Details

Returns: Promise<StatsMemberRecentRacesResponse>

Parameters:

• custId?: number - Customer ID (defaults to authenticated user)

Description: Returns the member’s most recent race results.

Example

const recentRaces = await iracing.stats.memberRecentRaces({
  custId: 123456
});

recentRaces.races.forEach(race => {
  console.log(`${race.seriesName} at ${race.trackName}`);
  console.log(`  Finished: P${race.finishPosition}`);
  console.log(`  iRating change: ${race.newIrating - race.oldIrating}`);
});

---

memberSummary(params?)

Get a quick summary of a member’s statistics.

Details

Returns: Promise<StatsMemberSummaryResponse>

Parameters:

• custId?: number - Customer ID (defaults to authenticated user)

Description: Returns a concise summary of the member’s racing statistics.

Example

const summary = await iracing.stats.memberSummary({
  custId: 123456
});

console.log('Member summary:', summary);

---

memberYearly(params?)

Get a member’s yearly statistics.

Details

Returns: Promise<StatsMemberYearlyResponse>

Parameters:

• custId?: number - Customer ID (defaults to authenticated user)

Description: Returns yearly aggregated statistics for the member.

Example

const yearly = await iracing.stats.memberYearly({
  custId: 123456
});

yearly.forEach(year => {
  console.log(`${year.year}: ${year.starts} starts, ${year.wins} wins`);
});

Season Standings

seasonDriverStandings(params)

Get driver standings for a season.

Details

Returns: Promise<StatsSeasonDriverStandingsResponse>

Parameters:

• seasonId: number (required) - The season ID
• carClassId: number (required) - The car class ID
• division?: number - Filter by division
• raceWeekNum?: number - Standings up to a specific week

Description: Returns driver championship standings for a specific season and car class.

The SDK validates seasonId + carClassId as a known pair before calling the API when validateSemanticParams is enabled.

Example

const standings = await iracing.stats.seasonDriverStandings({
  seasonId: 3456,
  carClassId: 789
});

// Filter by division
const divStandings = await iracing.stats.seasonDriverStandings({
  seasonId: 3456,
  carClassId: 789,
  division: 1
});

---

seasonSupersessionStandings(params)

Get supersession standings for a season.

Details

Returns: Promise<StatsSeasonSupersessionStandingsResponse>

Parameters:

• seasonId: number (required) - The season ID
• carClassId: number (required) - The car class ID
• division?: number - Filter by division
• raceWeekNum?: number - Standings up to a specific week

Description: Returns supersession standings for a specific season and car class.

The SDK validates seasonId + carClassId as a known pair before calling the API when validateSemanticParams is enabled.

Example

const standings = await iracing.stats.seasonSupersessionStandings({
  seasonId: 3456,
  carClassId: 789
});

---

seasonTeamStandings(params)

Get team standings for a season.

Details

Returns: Promise<StatsSeasonTeamStandingsResponse>

Parameters:

• seasonId: number (required) - The season ID
• carClassId: number (required) - The car class ID
• raceWeekNum?: number - Standings up to a specific week

Description: Returns team championship standings for a specific season and car class.

The SDK performs an additional semantic preflight check for this endpoint when validateSemanticParams is enabled (default). It verifies that seasonId and carClassId form a known valid pair from series metadata and throws an IRacingError with status 400 before making the request when the pair is invalid.

Example

const teamStandings = await iracing.stats.seasonTeamStandings({
  seasonId: 3456,
  carClassId: 789
});

Time Trial & Qualifying

seasonTtStandings(params)

Get time trial standings for a season.

Details

Returns: Promise<StatsSeasonTtStandingsResponse>

Parameters:

• seasonId: number (required) - The season ID
• carClassId: number (required) - The car class ID
• division?: number - Filter by division
• raceWeekNum?: number - Standings up to a specific week

Description: Returns time trial standings for a specific season and car class.

The SDK validates seasonId + carClassId as a known pair before calling the API when validateSemanticParams is enabled.

Example

const ttStandings = await iracing.stats.seasonTtStandings({
  seasonId: 3456,
  carClassId: 789
});

---

seasonTtResults(params)

Get time trial results for a specific week.

Details

Returns: Promise<StatsSeasonTtResultsResponse>

Parameters:

• seasonId: number (required) - The season ID
• carClassId: number (required) - The car class ID
• raceWeekNum: number (required) - The race week number
• division?: number - Filter by division

Description: Returns time trial results for a specific week in a season.

The SDK validates seasonId + carClassId as a known pair before calling the API when validateSemanticParams is enabled.

Example

const ttResults = await iracing.stats.seasonTtResults({
  seasonId: 3456,
  carClassId: 789,
  raceWeekNum: 5
});

---

seasonQualifyResults(params)

Get qualifying results for a specific week.

Details

Returns: Promise<StatsSeasonQualifyResultsResponse>

Parameters:

• seasonId: number (required) - The season ID
• carClassId: number (required) - The car class ID
• raceWeekNum: number (required) - The race week number
• division?: number - Filter by division

Description: Returns qualifying results for a specific week in a season.

The SDK validates seasonId + carClassId as a known pair before calling the API when validateSemanticParams is enabled.

Example

const qualResults = await iracing.stats.seasonQualifyResults({
  seasonId: 3456,
  carClassId: 789,
  raceWeekNum: 5
});

World Records

worldRecords(params)

Get world records for a car/track combination.

Details

Returns: Promise<StatsWorldRecordsResponse>

Parameters:

• carId: number (required) - The car ID
• trackId: number (required) - The track ID
• seasonYear?: number - Filter by year
• seasonQuarter?: number - Filter by quarter (1-4)

Description: Returns the world record lap times for a specific car and track combination.

Example

const records = await iracing.stats.worldRecords({
  carId: 123,
  trackId: 456
});

// Filter by season
const seasonRecords = await iracing.stats.worldRecords({
  carId: 123,
  trackId: 456,
  seasonYear: 2024,
  seasonQuarter: 3
});

Common Use Cases

Build a Driver Profile

async function getDriverProfile(custId: number) {
  const [career, bests, recentRaces, summary] = await Promise.all([
    iracing.stats.memberCareer({ custId }),
    iracing.stats.memberBests({ custId }),
    iracing.stats.memberRecentRaces({ custId }),
    iracing.stats.memberSummary({ custId }),
  ]);

  return { career, bests, recentRaces, summary };
}

Track Season Progress

async function getSeasonProgress(seasonId: number, carClassId: number) {
  const [driverStandings, teamStandings, ttStandings] = await Promise.all([
    iracing.stats.seasonDriverStandings({ seasonId, carClassId }),
    iracing.stats.seasonTeamStandings({ seasonId, carClassId }),
    iracing.stats.seasonTtStandings({ seasonId, carClassId }),
  ]);

  return { driverStandings, teamStandings, ttStandings };
}

See Also

• Member Service - Member profiles and chart data
• Results Service - Detailed race results
• Driver Stats Service - Category-specific statistics
• Services Overview - All available services