API DOCUMENTATION

The Data Driver API

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 / 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

03 / 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.

04 / 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 ↗

05 / 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
  }
}

06 / 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