API Documentation

Welcome to the chequered.tech F1 API documentation. Access comprehensive Formula 1 data including race results, driver standings, lap times, and historical statistics — all free and open.

Note: This API is currently a wrapper around the community Jolpica F1 API. All data is cached for 5 minutes to improve performance.

Quick Start

Get started with the F1 API in seconds. No authentication required.

// Example: Get 2024 driver standings
fetch('https://api.chequered.tech/api/standings/2024')
  .then(res => res.json())
  .then(data => console.log(data));

Base URL

All API requests should be made to:

https://api.chequered.tech

Response Format

All responses are returned in JSON format. Successful responses include relevant data, while errors return an error object with a descriptive message.

Success Response Example

{
  "season": 2024,
  "total": 20,
  "standings": [...]
}

Error Response Example

{
  "error": "Season must be a year between 1950 and 2030",
  "status": 400
}

Pagination

Most list endpoints support pagination using query parameters:

Parameter	Type	Default	Description
page	number	1	Page number to retrieve
limit	number	30	Items per page (max: 100)

General Endpoints

GET /api/health

Returns the API health status, uptime, and cache statistics.

Response

{
  "status": "ok",
  "uptime": 3600,
  "timestamp": "2024-01-15T10:30:00.000Z",
  "cacheSize": 42
}

GET /api/seasons

Get all available F1 seasons from 1950 to present.

Response

{
  "total": 75,
  "seasons": [
    { "season": 2024, "url": "http://..." },
    { "season": 2023, "url": "http://..." }
  ]
}

GET /api/champions

Get Formula 1 World Champions history with pagination support.

Query Parameters

Parameter	Type	Description
from	number	Starting year (default: 1950)
to	number	Ending year (default: current year)
page	number	Page number
limit	number	Results per page

POST /api/cache/clear

Clear the API cache. Useful for getting fresh data immediately.

Response

{
  "message": "Cache cleared",
  "entriesRemoved": 42
}

Standings

GET /api/standings/:season

Get driver standings for a specific season with detailed information.

Path Parameters

Parameter	Type	Description
season	number	Year between 1950 and 2030

Example Request

GET /api/standings/2024

GET /api/constructors/:season

Get constructor (team) standings for a specific season.

Path Parameters

Parameter	Type	Description
season	number	Year between 1950 and 2030

Example Request

GET /api/constructors/2024

Races & Results

GET /api/races/:season

Get the complete race calendar for a specific season.

Path Parameters

Parameter	Type	Description
season	number	Year between 1950 and 2030

Example Request

GET /api/races/2024

GET /api/races/:season/:round/results

Get race results for a specific round including finishing positions, lap times, and fastest laps.

Path Parameters

Parameter	Type	Description
season	number	Year between 1950 and 2030
round	number	Race round number (1-30)

Example Request

GET /api/races/2024/1/results

GET /api/races/:season/:round/qualifying

Get qualifying results for a specific race including Q1, Q2, and Q3 times.

Path Parameters

Parameter	Type	Description
season	number	Year between 1950 and 2030
round	number	Race round number (1-30)

Example Request

GET /api/races/2024/1/qualifying

GET /api/races/:season/:round/laps/:lap

Get lap times for all drivers on a specific lap of a race.

Path Parameters

Parameter	Type	Description
season	number	Year between 1950 and 2030
round	number	Race round number (1-30)
lap	number	Lap number

Example Request

GET /api/races/2024/1/laps/1

GET /api/races/:season/:round/pitstops

Get all pit stop data for a specific race including lap number, duration, and timing.

Path Parameters

Parameter	Type	Description
season	number	Year between 1950 and 2030
round	number	Race round number (1-30)

Example Request

GET /api/races/2024/1/pitstops

Drivers & Teams

GET /api/drivers/:driverId

Get detailed information about a specific driver.

Path Parameters

Parameter	Type	Description
driverId	string	Driver ID (e.g., "max_verstappen", "hamilton")

Example Request

GET /api/drivers/max_verstappen

GET /api/drivers/:driverId/career

Get complete career statistics for a driver including wins, podiums, championships, and more.

Path Parameters

Parameter	Type	Description
driverId	string	Driver ID (e.g., "max_verstappen", "hamilton")

Example Request

GET /api/drivers/max_verstappen/career

GET /api/drivers/season/:season

Get all drivers who participated in a specific season.

Path Parameters

Parameter	Type	Description
season	number	Year between 1950 and 2030

Example Request

GET /api/drivers/season/2024

GET /api/compare/:season/:driver1/:driver2

Compare statistics between two drivers in a specific season.

Path Parameters

Parameter	Type	Description
season	number	Year between 1950 and 2030
driver1	string	First driver ID
driver2	string	Second driver ID

Example Request

GET /api/compare/2024/max_verstappen/norris

GET /api/constructors/info/:constructorId

Get information about a specific constructor (team).

Path Parameters

Parameter	Type	Description
constructorId	string	Constructor ID (e.g., "red_bull", "ferrari")

Example Request

GET /api/constructors/info/red_bull

Statistics

GET /api/status/:season

Get a breakdown of finishing statuses (finished, DNF reasons, etc.) for a season.

Path Parameters

Parameter	Type	Description
season	number	Year between 1950 and 2030

Example Request

GET /api/status/2024

Need help? If you have questions or suggestions, feel free to reach out or contribute to the project.