# Formula 1 — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Track driver and constructor standings, view detailed race results and schedules, and explore driver profiles and awards from across Formula 1 history. Stay updated with comprehensive F1 season data including current standings, past race outcomes, and upcoming event schedules.

**Category:** Sports | **Website:** [f1.com/](https://f1.com/) | **Docs:** [parse.bot/marketplace/d116ca99-67a4-4ace-af58-b54855c83d82/f1-com-api](https://parse.bot/marketplace/d116ca99-67a4-4ace-af58-b54855c83d82/f1-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/parse-f1-com-api-d116ca99/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### Get awards

Returns season awards data including the DHL Fastest Lap Award (winner and per-race fastest laps) and DHL Fastest Pit Stop Award (per-race fastest pit stops). Each award includes race-by-race data with driver/team details.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `year` | string | No | Season year. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-f1-com-api-d116ca99/get_awards \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":"<string>"}'
```

### Get constructor standings

Returns constructor (team) championship standings for a given season year. Each standing includes position, team name, and total points. One request returns the full standings (no pagination).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `year` | string | No | Season year. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-f1-com-api-d116ca99/get_constructor_standings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":"<string>"}'
```

### Get driver profile

Returns driver profile and career information including biography, profile image, career stats (wins, podiums, poles, points), current season performance, and related articles. The driver slug is in firstname-lastname format.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `driver_slug` | string | Yes | Driver slug in firstname-lastname format (e.g., max-verstappen, lewis-hamilton, charles-leclerc). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-f1-com-api-d116ca99/get_driver_profile \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"driver_slug":"<string>"}'
```

### Get driver standings

Returns driver championship standings for a given season year. Each standing includes position, driver name, nationality, team, and points. One request returns the full season standings (no pagination).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `year` | string | No | Season year. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-f1-com-api-d116ca99/get_driver_standings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":"<string>"}'
```

### Get race result

Returns full race results for a specific meeting, including finishing positions, driver names, teams, lap times, points scored, laps completed, status, and gap to leader. Use meeting_id from get_race_results_by_season.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `meeting_id` | string | Yes | Meeting ID from get_race_results_by_season (e.g., 1229 for 2024 Bahrain Grand Prix). |
| `year` | string | No | Season year. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-f1-com-api-d116ca99/get_race_result \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"meeting_id":"<string>","year":"<string>"}'
```

### Get race results by season

Returns a list of all races (meetings) for a given season. Each race includes a meeting_id usable with get_race_result, the grand prix name, country code, and country name. One request returns all races for the season.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `year` | string | No | Season year. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-f1-com-api-d116ca99/get_race_results_by_season \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":"<string>"}'
```

### Get schedule

Returns the current F1 race calendar/schedule with all meeting dates, cities, timezones, and meeting IDs for the upcoming season. No parameters needed — returns the active calendar.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-f1-com-api-d116ca99/get_schedule \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```