# Driverdb — 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.

> Access driver performance data, detailed career statistics, and race results across all major motorsports series. Retrieve championship standings, team information, and head-to-head driver comparisons, and browse comprehensive profiles, race calendars, and circuit details.

**Category:** Sports | **Website:** [driverdb.com/](https://driverdb.com/) | **Docs:** [parse.bot/marketplace/04a4c464-317e-4d0a-a224-83f2173b697a/driverdb-com-api](https://parse.bot/marketplace/04a4c464-317e-4d0a-a224-83f2173b697a/driverdb-com-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/driverdb/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## Endpoints

### Get championship calendar

Retrieve the full race calendar for a specific championship and season. Returns all rounds with track info, dates, round number, and official event name.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Championship slug (e.g., 'formula-1') |
| `year` | string | No | Season year as string (e.g., '2025') |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/driverdb/get-championship-calendar \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>","year":"<string>"}'
```

### Get championship results

Get race results for a specific championship season. Returns completed rounds with podium positions, pole sitter, and fastest lap information.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Championship slug (e.g., 'formula-1') |
| `year` | string | No | Season year as string (e.g., '2025') |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/driverdb/get-championship-results \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>","year":"<string>"}'
```

### Get championship standings

Get driver standings for a specific championship and season year. Returns the full classification with positions, points, team name, and driver information. Data is parsed from the championship standings page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Championship slug (e.g., 'formula-1', 'dtm', 'indycar-series') |
| `year` | string | No | Season year as string (e.g., '2025', '2024') |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/driverdb/get-championship-standings \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>","year":"<string>"}'
```

### Get driver career stats

Retrieve detailed career season-by-season statistics for a driver. Returns every season the driver competed in with championship name, team, year, finishing position, races, wins, poles, podiums, and points.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Driver slug identifier (e.g., 'max-verstappen') |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/driverdb/get-driver-career-stats \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### Get driver head to head

Compare two drivers head-to-head across all shared championships. Returns both driver profiles with stats, common championships they competed in, and detailed comparison data.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug1` | string | Yes | First driver slug (e.g., 'max-verstappen') |
| `slug2` | string | Yes | Second driver slug (e.g., 'lewis-hamilton') |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/driverdb/get-driver-head-to-head \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"slug1":"<string>","slug2":"<string>"}'
```

### Get driver profile

Get comprehensive profile data for a specific driver including biographical information, nationality, current championship, and aggregate race statistics such as wins, poles, podiums, and Sharp ELO rating.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Driver slug identifier (e.g., 'max-verstappen', 'lewis-hamilton', 'lando-norris') |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/driverdb/get-driver-profile \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### Get driver race results

Get recent individual race results for a specific driver. Returns a list of recent races with finish position, grid position, team, laps, championship points, and session/event details.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Driver slug identifier (e.g., 'max-verstappen') |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/driverdb/get-driver-race-results \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### Get driverdb top100

Retrieve the DriverDB top-rated driver ranking based on Sharp ELO-style ratings. Returns up to 100 drivers sorted by rating descending, with full profile and statistics.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/driverdb/get-driverdb-top100 \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get homepage featured

Retrieve the homepage featured content including top-rated drivers, latest news headlines from motorsport sources, and latest race results across all championships.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/driverdb/get-homepage-featured \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get news article

Retrieve content for a specific news article page on DriverDB. Returns article data and trending articles. Note: most news items on DriverDB are aggregated from external sources; this endpoint works for articles that have an internal DriverDB page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Article slug from the news page URL path (e.g., 'hill-back-at-williams-f1-30-years-after-leaving') |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/driverdb/get-news-article \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### Get race result detail

Get the results listing page for a specific event. Returns recent race results with event info, championship, track, and winners. The result_id corresponds to an event_id from championship calendar data.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `result_id` | string | Yes | Event ID from championship calendar/results data (e.g., '59209') |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/driverdb/get-race-result-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"result_id":"<string>"}'
```

### Get rising stars

Retrieve a list of top-rated young drivers (age 25 and under) from the DriverDB rankings. Filters active drivers by age to identify rising talent across all championships.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/driverdb/get-rising-stars \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get team profile

Get detailed profile for a specific team including current drivers, season stats, team principal, headquarters, and colour scheme. Returns data for the team's most recent season in their primary championship.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Team slug (e.g., 'mclaren', 'red-bull', 'ferrari') |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/driverdb/get-team-profile \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### Get track detail

Get detailed information about a specific circuit/track including official name, country, and all track layout configurations with lengths and active periods.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Track slug (e.g., 'albert-park', 'silverstone', 'monza') |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/driverdb/get-track-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### List championships

List all motorsport championships available in the database. Returns up to 100 championships with name, country, and identifier.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/driverdb/list-championships \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### List news

Retrieve the latest motorsport news article summaries. Returns recent news items from external motorsport publications aggregated by DriverDB, including headline, introduction, source, date, and external link URL.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/driverdb/list-news \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### List teams

List motorsport teams available in the database. Returns up to 100 teams with name, country, and identifier.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/driverdb/list-teams \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### List tracks

List all race tracks and circuits available in the database. Returns up to 100 tracks with name, country, and layout information.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/driverdb/list-tracks \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Search drivers

Search for drivers by name. Returns matching drivers with full profile information and career statistics from the DriverDB API.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword to filter driver names (e.g., 'verstappen', 'hamilton', 'norris') |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/driverdb/search-drivers \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.