# iracing-api

> Javascript client for iracing API

Latest version **0.5.2** (published 2025-04-12) · MIT license · 0 weekly downloads

## Install

```sh
npm install iracing-api
pnpm add iracing-api
yarn add iracing-api
bun add iracing-api
```

## Health

**Score 35/100 (D)** — status: maintenance-mode.

Positive: has types; esm support; no vulnerabilities.

Warnings: low downloads; pre 1.0.

Negative: stale; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.5.2 |
| Published | 2025-04-12 |
| First published | 2023-02-10 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM |
| Dependencies | 4 |
| Unpacked size | 897.5 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 13 |
| Author | Michal Dyczkowski |
| Maintainers | themich4 |
| Keywords | iracing, api, client, javascript, typescript, iracing-api, iracing-api-client |

## Links

- npm: https://www.npmjs.com/package/iracing-api
- Repository: https://github.com/TheMich4/iracing-api
- Homepage: https://iracing-api.dyczkowski.dev/
- Issues: https://github.com/TheMich4/iracing-api/issues
- npm.io page: https://npm.io/package/iracing-api

## Dependencies (4)

- [zod](https://npm.io/package/zod.md) ^3.22.4
- [humps](https://npm.io/package/humps.md) ^2.0.1
- [crypto-js](https://npm.io/package/crypto-js.md) ^4.1.1
- [fetch-cookie](https://npm.io/package/fetch-cookie.md) ^2.1.0

## Alternatives

- [launchdarkly-js-client-sdk](https://npm.io/package/launchdarkly-js-client-sdk.md) — 2.5M weekly downloads
- [@elastic/elasticsearch](https://npm.io/package/@elastic/elasticsearch.md) — 2.1M weekly downloads
- [@c8y/client](https://npm.io/package/@c8y/client.md) — 15.3K weekly downloads
- [@signaldb/maverickjs](https://npm.io/package/@signaldb/maverickjs.md) — 1.7K weekly downloads
- [@bbc/http-transport-cache](https://npm.io/package/@bbc/http-transport-cache.md) — 1.2K weekly downloads

## Recent versions

- 0.5.2 (latest) — 2025-04-12
- 0.5.1 — 2025-04-12
- 0.5.0 — 2025-04-12
- 0.4.7 — 2025-04-05
- 0.4.6 — 2025-04-05
- 0.4.5 — 2025-03-29
- 0.4.4 — 2024-09-14
- 0.4.3 — 2024-04-08
- 0.4.2 — 2024-04-06
- 0.4.1 — 2024-01-23
- 0.4.0 — 2024-01-08
- 0.3.4 — 2023-12-30
- 0.3.3 — 2023-12-25
- 0.3.2 — 2023-12-17
- 0.3.1 — 2023-11-26
- … 31 more at https://npm.io/package/iracing-api/versions

## README

# iracing-api

[Full docs](https://iracing-api.dyczkowski.dev/)

## Installation

```bash
npm install iracing-api
yarn add iracing-api
pnpm i iracing-api
bun i iracing-api
```

## Basic Usage

```typescript
import IracingAPI from 'iracing-api'

const irUser = 'FOO@gmail.com'
const irPass = 'BAR'

const main = async () => {
    const ir = new IracingAPI()

    // First you have to login to iracing using your credentials to be able to use the API.
    await ir.login(irUser, irPass)

    // Now you can use any endpoint, e.g. getCars
    const cars = await ir.car.getCars()

    console.log(cars)
}

main().then(() => 'Done')
```

## Endpoint Mapping

| API Class       | Method Name                      | Endpoint Path                              |
| --------------- | -------------------------------- | ------------------------------------------ |
| `CarAPI`        | `getCarAssets`                   | `data/car/assets`                          |
| `CarAPI`        | `getCars`                        | `data/car/get`                             |
| `CarClassAPI`   | `getCarClasses`                  | `data/carclass/get`                        |
| `ConstantsAPI`  | `getCategories`                  | `data/constants/categories`                |
| `ConstantsAPI`  | `getDivisions`                   | `data/constants/divisions`                 |
| `ConstantsAPI`  | `getEventTypes`                  | `data/constants/event_types`               |
| `HostedAPI`     | `getHostedCombinedSessions`      | `data/hosted/combined_sessions`            |
| `HostedAPI`     | `getHostedSessions`              | `data/hosted/sessions`                     |
| `LeagueAPI`     | `getCustLeagueSessions`          | `data/league/cust_league_sessions`         |
| `LeagueAPI`     | `getLeagueDirectory`             | `data/league/directory`                    |
| `LeagueAPI`     | `getLeagueData`                  | `data/league/get`                          |
| `LeagueAPI`     | `getLeaguePointSystem`           | `data/league/get_points_systems`           |
| `LeagueAPI`     | `getLeagueMembership`            | `data/league/membership`                   |
| `LeagueAPI`     | `getLeagueSeasons`               | `data/league/seasons`                      |
| `LeagueAPI`     | `getLeagueSeasonStandings`       | `data/league/season_standings`             |
| `LeagueAPI`     | `getLeagueSeasonSessions`        | `data/league/season_sessions`              |
| `LookupAPI`     | `getClubHistory`                 | `data/lookup/club_history`                 |
| `LookupAPI`     | `getCountries`                   | `data/lookup/countries`                    |
| `LookupAPI`     | `getDrivers`                     | `data/lookup/drivers`                      |
| `LookupAPI`     | `getLicenses`                    | `data/lookup/licenses`                     |
| `MemberAPI`     | `getMemberAwards`                | `data/member/awards`                       |
| `MemberAPI`     | `getMemberChartData`             | `data/member/chart_data`                   |
| `MemberAPI`     | `getMemberData`                  | `data/member/get`                          |
| `MemberAPI`     | `getMemberInfo`                  | `data/member/info`                         |
| `MemberAPI`     | `getMemberParticipationCredits`  | `data/member/participation_credits`        |
| `MemberAPI`     | `getMemberProfile`               | `data/member/profile`                      |
| `ResultsAPI`    | `getResult`                      | `data/results/get`                         |
| `ResultsAPI`    | `getResultsEventLog`             | `data/results/event_log`                   |
| `ResultsAPI`    | `getResultsLapChartData`         | `data/results/lap_chart_data`              |
| `ResultsAPI`    | `getResultsLapData`              | `data/results/lap_data`                    |
| `ResultsAPI`    | `searchHosted`                   | `data/results/search_hosted`               |
| `ResultsAPI`    | `searchSeries`                   | `data/results/search_series`               |
| `ResultsAPI`    | `getSeasonResults`               | `data/results/season_results`              |
| `SeasonAPI`     | `getSeasonList`                  | `data/season/list`                         |
| `SeasonAPI`     | `getSeasonRaceGuide`             | `data/season/race_guide`                   |
| `SeasonAPI`     | `getSpectatorSubsessionIds`      | `data/season/spectator_subsession_ids`     |
| `SeriesAPI`     | `getSeriesAssets`                | `data/series/assets`                       |
| `SeriesAPI`     | `getSeriesData`                  | `data/series/get`                          |
| `SeriesAPI`     | `getSeriesPastSeasons`           | `data/series/past_seasons`                 |
| `SeriesAPI`     | `getSeriesSeasons`               | `data/series/seasons`                      |
| `SeriesAPI`     | `getSeriesStats`                 | `data/series/stats_series`                 |
| `StatsAPI`      | `getMemberBests`                 | `data/stats/member_bests`                  |
| `StatsAPI`      | `getMemberCareer`                | `data/stats/member_career`                 |
| `StatsAPI`      | `getMemberDivision`              | `data/stats/member_division`               |
| `StatsAPI`      | `getMemberRecentRaces`           | `data/stats/member_recent_races`           |
| `StatsAPI`      | `getMemberRecap`                 | `data/stats/member_recap`                  |
| `StatsAPI`      | `getMemberSummary`               | `data/stats/member_summary`                |
| `StatsAPI`      | `getMemberYearlyStats`           | `data/stats/member_yearly`                 |
| `StatsAPI`      | `getDriverSeasonStandings`       | `data/stats/season_driver_standings`       |
| `StatsAPI`      | `getSupersessionSeasonStandings` | `data/stats/season_supersession_standings` |
| `StatsAPI`      | `getTeamSeasonStandings`         | `data/stats/season_team_standings`         |
| `StatsAPI`      | `getTimeTrialSeasonStandings`    | `data/stats/season_tt_results`             |
| `StatsAPI`      | `getQualifySeasonStandings`      | `data/stats/season_qualify_results`        |
| `StatsAPI`      | `getWorldRecords`                | `data/stats/world_records`                 |
| `TeamAPI`       | `getTeamData`                    | `data/team/get`                            |
| `TimeAttackAPI` | `getTimeAttackSeasonResults`     | `data/time_attack/member_season_results`   |
| `TrackAPI`      | `getTrackAssets`                 | `data/track/assets`                        |
| `TrackAPI`      | `getTracks`                      | `data/track/get`                           |

---
_Source: https://npm.io/package/iracing-api · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
