# NASCAR Race Schedule and Results API

> NASCAR Cup, Xfinity and Truck series schedules, race weekend results and the live timing feed

- Vendor: `nascarracescheduleandresultsap` · version 1.0 · category Sports · tags nascar api, motorsport api, racing results api, nascar schedule api, live timing api, sports data api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/nascarracescheduleandresultsap
- This document: https://apiclay.com/docs/nascarracescheduleandresultsap.md
- OpenAPI 3.1: https://apiclay.com/api/nascarracescheduleandresultsap/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `nascarracescheduleandresultsap`
- Updated: 2026-11-18

## About

## NASCAR Race Schedule and Results API

Data from the feeds behind nascar.com: a season's schedule for a series (practice, qualifying and race sessions with tracks, times and TV), a race weekend's full results (finishing order, laps led, stage results, qualifying), and the live timing feed during a session (lap, flag state, running order).

Data comes from **nascar.com** (https://www.nascar.com). Every route calls the source's own public API and returns it unchanged.

Typical flow: `/schedule?year=2026&amp;series_id=1` to get a `race_id`, then `/weekend?year=2026&amp;series_id=1&amp;race_id=5601`; `/live` while a session runs.

### Routes

#### GET `/schedule` - Season schedule
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| year | path | number | yes | Season, e.g. `2026`. |
| series_id | path | number | yes | `1` Cup, `2` Xfinity, `3` Truck. |

Returns: array of sessions with `race_id`, `race_name`, `track_name`, `event_name`, `start_time`, `end_time`, `run_type`, `notes`.

#### GET `/weekend` - Race weekend
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| year | path | number | yes | Season. |
| series_id | path | number | yes | Series id. |
| race_id | path | number | yes | `race_id` from `/schedule`. |

Returns: `weekend_race[]` with `results[]` (driver, car number, finishing position, laps, laps led, points), `stage_results`, `caution_segments`, plus `weekend_runs[]` (practice, qualifying).

#### GET `/live` - Live feed
No parameters.

Returns: `race_id`, `run_name`, `lap_number`, `laps_to_go`, `flag_state`, `vehicles[]` with running order and lap times; empty `vehicles` when no session is running.

### Caveats

- Feeds are unofficial and unversioned; check NASCAR's terms before commercial use.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by nascar.com.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /schedule — Season schedule
- Gateway: `GET https://api.apiclay.com/v1/api/nascarracescheduleandresultsap/schedule`
- Public query params: `year` (string, required), `series_id` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /weekend — Race weekend
- Gateway: `GET https://api.apiclay.com/v1/api/nascarracescheduleandresultsap/weekend`
- Public query params: `year` (string, required), `series_id` (string, required), `race_id` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /live — Live feed
- Gateway: `GET https://api.apiclay.com/v1/api/nascarracescheduleandresultsap/live`
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/nascarracescheduleandresultsap/schedule?year=<year>&series_id=<series_id>" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
