Skip to content
SportsDataAPI Real-time sports data

Formula-1 API Documentation

v1.3.1 13 endpoints
https://v1.formula-1.sportsdataapi.com
Start Free Trial Back to Formula-1 API

Endpoints

Timezone (1) Seasons (1) Competitions (1) Circuits (1) Teams (1) Drivers (1) Races (1) Rankings (5) Pit Stops (1)

Timezone

1 endpoint
GET /timezone timezone
Get the list of available timezone to be used in the races endpoint.

This endpoint does not require any parameters.
GET https://v1.formula-1.sportsdataapi.com/timezone

This endpoint does not require any query parameters.

Seasons

1 endpoint
GET /seasons seasons
Get all seasons available.

All seasons are only 4-digit keys. All results can be used in other endpoints as filters.

This endpoint does not require any parameters.
GET https://v1.formula-1.sportsdataapi.com/seasons

This endpoint does not require any query parameters.

Competitions

1 endpoint
GET /competitions competitions
Get the list of available competitions.

The competition id are unique in the API and competitions keep it across all seasons

All the parameters of this endpoint can be used together.
GET https://v1.formula-1.sportsdataapi.com/competitions

Query Parameters

Name Type Required Description
id integer The id of the competition
name string The name of the competition
country string The name of the country
city string The name of the city
search string Allow to search for a competition name

Circuits

1 endpoint
GET /circuits circuits
Get the list of available circuits.

The circuit id are unique in the API and circuits keep it across all seasons

Sample image of a circuit :

![circuit](https://media.sportsdataapi.com/formula-1/circuits/1.png)

All the parameters of this endpoint can be used together.
GET https://v1.formula-1.sportsdataapi.com/circuits

Query Parameters

Name Type Required Description
id integer The id of the circuit
competition integer The id of the competition
name string The name of the circuit
search string Allow to search for a circuit name

Teams

1 endpoint
GET /teams teams
Get the list of available competitions.

The team id are unique in the API and teams keep it across all seasons

Sample logo of a team :

![team](https://media.sportsdataapi.com/formula-1/teams/5.png)

All the parameters of this endpoint can be used together.
GET https://v1.formula-1.sportsdataapi.com/teams

Query Parameters

Name Type Required Description
id integer The id of the team
name string The name of the team
search string Allow to search for a team name

Drivers

1 endpoint
GET /drivers drivers
Get the list of available drivers.

The driver id are unique in the API and drivers keep it across all seasons

Sample image of a driver :

![circuit](https://media.sportsdataapi.com/formula-1/drivers/20.png)

All the parameters of this endpoint can be used together.

This endpoint require at least one parameter.
GET https://v1.formula-1.sportsdataapi.com/drivers

Query Parameters

Name Type Required Description
id integer The id of the driver
name string The name of the driver
search string Allow to search for a driver name

Races

1 endpoint
GET /races races
Get the list of available races for a competition.

For all requests to races you can add the query parameter timezone to your request in order to retrieve the list of races in the time zone of your choice like *“Europe/London“*

To know the list of available time zones you have to use the endpoint timezone

Available Status * Live * Completed * Cancelled * Postponed * Scheduled

Available Types * Race * 1st Qualifying * 2nd Qualifying * 3rd Qualifying * Sprint * 1st Sprint Shootout * 2nd Sprint Shootout * 3rd Sprint Shootout * 1st Practice * 2nd Practice * 3rd Practice

This endpoint requires at least one of these parameters id, date, next, last and season.

All the parameters of this endpoint can be used together.
GET https://v1.formula-1.sportsdataapi.com/races

Query Parameters

Name Type Required Description
id integer The id of the race
date string A valid date
next integer The x next races
last integer The x last races
competition integer The id of the competition
circuit integer The id of the circuit
season integer The season of the race
type string The type of the race
Race1st Qualifying2nd Qualifying3rd QualifyingSprint1st Sprint Shootout2nd Sprint Shootout3rd Sprint Shootout1st Practice2nd Practice3rd Practice
timezone string A valid timezone

Rankings

5 endpoints
GET /rankings/teams rankings/teams
Get the teams rankings for a season.

All the parameters of this endpoint can be used together.
GET https://v1.formula-1.sportsdataapi.com/rankings/teams

Query Parameters

Name Type Required Description
season string The season
team integer The id of the team
GET /rankings/drivers rankings/drivers
Get the drivers rankings for a season.

All the parameters of this endpoint can be used together.
GET https://v1.formula-1.sportsdataapi.com/rankings/drivers

Query Parameters

Name Type Required Description
season integer The season
driver integer The id of the driver
team integer The id of the team
GET /rankings/races rankings/races
Get the rankings for a race.

All the parameters of this endpoint can be used together.
GET https://v1.formula-1.sportsdataapi.com/rankings/races

Query Parameters

Name Type Required Description
race integer The id of the race
team integer The id of the team
driver integer The id of the driver
GET /rankings/fastestlaps rankings/fastestlaps
Get the ranking of the fastest laps for a race.

All the parameters of this endpoint can be used together.
GET https://v1.formula-1.sportsdataapi.com/rankings/fastestlaps

Query Parameters

Name Type Required Description
race integer The id of the race
team integer The id of the team
driver integer The id of the driver
GET /rankings/startinggrid rankings/startinggrid
Get the starting grid for a race.

All the parameters of this endpoint can be used together.
GET https://v1.formula-1.sportsdataapi.com/rankings/startinggrid

Query Parameters

Name Type Required Description
race integer The id of the race
team integer The id of the team
driver integer The id of the driver

Pit Stops

1 endpoint
GET /pitstops pitstops
Get the list of pit stops made by all drivers during a race.

All the parameters of this endpoint can be used together.
GET https://v1.formula-1.sportsdataapi.com/pitstops

Query Parameters

Name Type Required Description
race integer The id of the race
team integer The id of the team
driver integer The id of the driver

Quick Reference

Base URL

https://v1.formula-1.sportsdataapi.com

Authentication

x-apisports-key: YOUR_API_KEY
cURL 
curl -X GET "https://v1.formula-1.sportsdataapi.com/timezone" \
  -H "x-apisports-key: YOUR_API_KEY"

Start free. Scale when ready.

Get 100 free formula-1 API requests per day. No credit card required.

Upgrade to PRO for full real-time data, live odds, and unlimited historical access.

Start Free Trial View Pricing Plans

Already have an account?