NASCAR

NASCAR API endpoints

• GET/v1/nascar/drivers

  List all NASCAR drivers

  Retrieve a paginated list of NASCAR drivers. Returns basic driver information including name, number, country, and birth date. Supports pagination with a maximum limit of 50 per page. ### Usage ```bash curl -X GET "https://nascar.jojapi.net/v1/nascar/drivers?page=1&limit=20" \ -H "X-JoJAPI-Key: YOUR_API_KEY" ```

• GET/v1/nascar/drivers/{id}

  Get driver details by ID

  Retrieve detailed information about a specific NASCAR driver by their unique ID, including personal information and career history. ### Usage ```bash curl -X GET "https://nascar.jojapi.net/v1/nascar/drivers/7c9a4314-8d6f-4f6a-9bfe-2f1d56a30b6a" \ -H "X-JoJAPI-Key: YOUR_API_KEY" ```

• GET/v1/nascar/events

  List all NASCAR events

  Retrieve a paginated list of NASCAR events. Supports pagination with a maximum limit of 50 events per page, plus an optional `year` filter to scope results to a single season. ### Usage ```bash curl -X GET "https://nascar.jojapi.net/v1/nascar/events?page=1&limit=20" \ -H "X-JoJAPI-Key: YOUR_API_KEY" ```

• GET/v1/nascar/events/{id}

  Get event details by ID

  Retrieve detailed information about a specific NASCAR event, including sessions, location, and adjacent-event navigation. ### Usage ```bash curl -X GET "https://nascar.jojapi.net/v1/nascar/events/7c9a4314-8d6f-4f6a-9bfe-2f1d56a30b6a" \ -H "X-JoJAPI-Key: YOUR_API_KEY" ```

• GET/v1/nascar/events/{eventId}/sessions

  List sessions for an event

  Return every session that belongs to a NASCAR event (practice, qualifying, sprint, race) in chronological order.

• GET/v1/nascar/events/{eventId}/sessions/{sessionId}

  Get a single session with results

  Return session metadata plus the full results table for that session.

• GET/v1/nascar/events/{eventId}/sessions/{sessionId}/lap-chart

  Get the lap chart for a session

  Position-by-lap running order (car number per cell), continuous across stages (lap 0 is the start). Defaults to JSON; use ?format=csv for a pivoted grid or ?format=txt for a printed lap chart.

• GET/v1/nascar/events/{eventId}/sessions/{sessionId}/lap-times

  Get individual lap times for a session

  Per-driver lap times (seconds) as a car×lap grid, continuous across stages. Defaults to JSON; use ?format=csv or ?format=txt for a downloadable file.

• GET/v1/nascar/events/{eventId}/sessions/{sessionId}/results

  Get session results only

  Return just the results array for a session. Use the parent endpoint if you also need the session metadata.

• GET/v1/nascar/events/{eventId}/sessions/{sessionId}/stages

  Get stage results for a race session

  Return the stage-by-stage results for a completed NASCAR Cup Series race. Each stage lists the official points-paying top 10 with the stage points earned, extended to the full field running order (stagePoints 0 from position 11) where per-lap timing data exactly confirms the official top 10; stages where the two disagree carry only the top 10. The final stage is not listed; its outcome is the race classification (see the session results endpoint). Coverage: 2020 to present (stage racing began in 2017, but the upstream data source only publishes stage results from 2020 onward). ### Usage ```bash curl -X GET "https://nascar.jojapi.net/v1/nascar/events/EVENT_UUID/sessions/SESSION_UUID/stages" \ -H "X-JoJAPI-Key: YOUR_API_KEY" ```

• GET/v1/nascar/locations

  List all NASCAR circuit locations

  Retrieve a paginated list of NASCAR circuit locations. ### Usage ```bash curl -X GET "https://nascar.jojapi.net/v1/nascar/locations?page=1&limit=20" \ -H "X-JoJAPI-Key: YOUR_API_KEY" ```

• GET/v1/nascar/locations/{id}

  Get circuit/location details by ID

  Retrieve detailed information about a specific NASCAR circuit by its unique ID.

• GET/v1/nascar/seasons

  List all NASCAR seasons

  Retrieve a paginated list of NASCAR championship seasons. ### Usage ```bash curl -X GET "https://nascar.jojapi.net/v1/nascar/seasons?page=1&limit=20" \ -H "X-JoJAPI-Key: YOUR_API_KEY" ```

• GET/v1/nascar/seasons/{id}

  Get season details by ID

  Retrieve detailed information about a specific NASCAR season by its unique ID. Season IDs come from the season list endpoint. ### Usage ```bash curl -X GET "https://nascar.jojapi.net/v1/nascar/seasons/7c9a4314-8d6f-4f6a-9bfe-2f1d56a30b6a" \ -H "X-JoJAPI-Key: YOUR_API_KEY" ```

• GET/v1/nascar/seasons/{id}/drivers

  Get season driver statistics

  Retrieve driver statistics for a specific NASCAR season, including championship points, wins, podiums, pole positions, and DNFs.

• GET/v1/nascar/seasons/{id}/teams

  Get season team statistics

  Retrieve team statistics for a specific NASCAR season, including championship points, wins, podiums, and 1-2 finishes.

• GET/v1/nascar/teams

  List all NASCAR teams

  Retrieve a paginated list of every team that has competed in the NASCAR Cup Series across the coverage period. Supports pagination with a maximum limit of 50 per page. ### Usage ```bash curl -X GET "https://nascar.jojapi.net/v1/nascar/teams?page=1&limit=20" \ -H "X-JoJAPI-Key: YOUR_API_KEY" ```

• GET/v1/nascar/teams/{id}

  Get team details by ID

  Retrieve detailed information about a specific NASCAR team, including its sport, country, and metadata.

• GET/v1/nascar/export/laps

  Download a full NASCAR Cup Series season of lap-by-lap data

  Race lap-by-lap for the season: every car's lap time, speed and running position. Coverage 2020 onward.

• GET/v1/nascar/export/results

  Download a full NASCAR Cup Series season of session results

  Every result for every session of the season as one download (CSV or NDJSON) instead of thousands of paginated calls.

• GET/v1/nascar/standings/drivers

  Get NASCAR driver standings

  Retrieve the NASCAR driver championship standings. Optionally pass a year to retrieve historical standings; if no year is provided, returns the current season. ### Usage ```bash curl -X GET "https://nascar.jojapi.net/v1/nascar/standings/drivers?year=2025" \ -H "X-JoJAPI-Key: YOUR_API_KEY" ```

• GET/v1/nascar/standings/manufacturers

  Get NASCAR manufacturer standings

  Retrieve the NASCAR Manufacturers’ championship standings (Chevrolet, Ford, Toyota). Coverage: 2010 to present. Optionally pass a year for historical standings. ### Usage ```bash curl -X GET "https://nascar.jojapi.net/v1/nascar/standings/manufacturers?year=2025" \ -H "X-JoJAPI-Key: YOUR_API_KEY" ```

• GET/v1/nascar/standings/owners

  Get NASCAR owner standings

  Retrieve the NASCAR owner championship standings (keyed by car owner and number, distinct from the team championship). Optionally pass a year for historical standings. ### Usage ```bash curl -X GET "https://nascar.jojapi.net/v1/nascar/standings/owners?year=2026" \ -H "X-JoJAPI-Key: YOUR_API_KEY" ```

• GET/v1/nascar/live/sessions/{sessionId}/leaderboard

  Get the live leaderboard for a NASCAR session

  Retrieve the live running order for a NASCAR session: position, car number, driver, gap to leader, last lap, best lap speed, laps led and on-track status.

• GET/v1/nascar/live/sessions/{sessionId}/status

  Get live race/stage status for a NASCAR session

  Retrieve the live status of a NASCAR session: flag state, run type, current lap and laps remaining, and the current stage (NASCAR runs staged races).