API DOCUMENTATION

The Data Driver API

Name: The Data Driver F1 API
Creator: The Data Driver

A public read API for Formula 1 data, model outputs and published analysis. WEC contracts are documented but remain data-gated until official classifications pass validation. The live OpenAPI contract is the source of truth.

Open live OpenAPI docs ↗

01 / QUICK START

bash

curl "https://api.thedatadriver.app/v1/f1/drivers?season=2026"

Base URL: https://api.thedatadriver.app/v1

02 / MCP & AI

Use with Claude or ChatGPT

Explore published Formula 1 data in your assistant through 21 read-only tools. Each result includes a source URL and availability details. Historical OpenF1 enrichment is non-official and licensed CC BY-NC-SA 4.0 for non-commercial use.

Add a custom MCP connector in Claude, or enable ChatGPT Developer mode on an eligible plan, then use this Streamable HTTP URL:

https://thedatadriver.app/api/mcp

Ask for a race or driver, then request the published classification or standings. Cite the linked API source and treat missing data as unavailable.

03 / ENDPOINTS

Endpoint Categories

F1 resources currently published by the API contract

Calendar

Published

Race weekends and season schedule

Drivers

Published

Driver profiles, classifications and career data

Teams

Published

Constructor profiles and team data

Races & Results

Published

Classifications, fastest laps, laps and pit stops

Qualifying & Sprint

Published

Qualifying and sprint-session results

Safety, Weather & Control

Published

Safety cars, incidents, weather and race control

Standings

Published

Drivers and constructors championship tables

Penalties

Published

Season and race penalties plus penalty points

Circuits

Published

Circuit profiles and track metadata

Records

Published

Driver, team and streak records

Predictions

Published

Race, qualifying, championship and track-record outputs

Model & Articles

Published

Model information, changelog and published analysis

Selecting a season

Season selection is not uniform across the contract — check the live OpenAPI schema for each route before assuming one form:

?season= is an optional query parameter, but its default differs by route: on /v1/f1/drivers and /v1/f1/teams it defaults to 2026; on /v1/f1/circuits it is unset by default and returns every circuit; on /v1/f1/predictions/track-record it is unset by default and returns the latest scored season. Pass an explicit value on any of these routes to pin a season.
The championship classification and standings routes take the year as a required path segment instead, not a query string: /v1/f1/standings/drivers/{year}, /v1/f1/standings/constructors/{year} and /v1/f1/drivers/classifications/{season}.

04 / LIVE CONTRACT

Formula 1 contract. Published and live.

The documentation describes only resources available from the public API today. Future series are added here after their endpoints pass the same readiness and provenance checks.

/v1/f1/...

Formula 1

Public endpoints defined by the live OpenAPI contract.

Live

WEC remains data-gated: it is not advertised as a public API contract until official-source coverage and its OpenAPI endpoints are live.

05 / ACCESS

Read the live contract

Access rules, rate limits and availability belong to the API deployment. This page does not advertise quotas or paid plans that are not published by the live service.

Open live OpenAPI docs ↗

06 / RESPONSE FORMAT

Standard response structure

Every endpoint returns a consistent envelope. The meta object includes source attribution, series context, and cache information.

json

{
  "status": "ok",
  "data": { ... },
  "meta": {
    "source": "openf1.org",
    "source_url": "https://openf1.org/",
    "license": "CC BY-NC-SA 4.0",
    "license_url": "https://creativecommons.org/licenses/by-nc-sa/4.0/",
    "attribution": "Contains data from OpenF1 (https://openf1.org/).",
    "adaptation_notice": "Adapted by The Data Driver for non-commercial analysis.",
    "data_fetched_at": "2026-03-15T11:55:00Z",
    "series": "f1",
    "timestamp": "2026-03-15T12:00:00Z",
    "cache_ttl": 300
  }
}

07 / DATA INDEPENDENCE

Official truth, attributed enrichment

Formula1.com remains authoritative for sporting results and standings. Post-session analytical enrichment from OpenF1 is non-commercial, replaceable, and returned with its CC BY-NC-SA 4.0 attribution.

formula1.com

Official race results, classifications, standings

FIA

Regulations, steward decisions, technical directives, penalties

OpenF1 historical

Post-session analysis enrichment under CC BY-NC-SA 4.0

Historical archive

Complete race data from 1950 to present, digitised and normalised