API DOCUMENTATION

The Data Driver API

A public read API for Formula 1 data, model outputs and published analysis. 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/russell

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

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": "tdd",
    "series": "f1",
    "timestamp": "2026-03-15T12:00:00Z",
    "cache_ttl": 300
  }
}

06 / DATA INDEPENDENCE

Fully independent infrastructure

Unlike other motorsport APIs, we connect directly to primary sources. Our data infrastructure is fully independent — zero dependency on third-party APIs.

F1 Live Timing

Real-time session data, lap times, telemetry streams

formula1.com

Official race results, classifications, standings

FIA

Regulations, steward decisions, technical directives, penalties

Historical archive

Complete race data from 1950 to present, digitised and normalised