API-Formula-1

Follow Formula 1 with API-Formula-1: every Grand Prix and its sessions since 2012, with results, fastest laps, starting grids and pit stops, circuits, teams and drivers with their careers, and the drivers' and constructors' championships. Needs an API-SPORTS key; the free plan allows 100 requests a day.

Actions

Action	What it does
Find circuits	Find circuits by name, by Grand Prix or by ID, each with its map, lap length, race distance, lap record, capacity and first Grand Prix.
Find drivers	Find drivers by name or ID, each with their nationality, birthday, car number, championships, podiums, career points and the team they drove for each season.
Find Grands Prix	Find Grands Prix by name, country or city, each with its ID and where it is held.
Find teams	Find teams by name or ID, each with its base, championships, pole positions, fastest laps, principal, chassis, engine and tyres.
Get a race	Get one session by ID: its Grand Prix, circuit, type, status, laps, distance and fastest lap.
Get account status	See the connected key's API-Formula-1 plan, when it renews, and how many of today's requests are used and left.
Get fastest laps	Get each driver's fastest lap of a session, fastest first: the lap it was on, its time and the average speed.
Get pit stops	Get every pit stop of a race: the driver, their team, which stop it was, the lap and how long it took.
Get race results	Get a session's results in finishing order: each driver's place, time and laps, with their grid slot and pit stops in a race or sprint.
Get the constructors' championship	Get a season's constructors' championship: each team's place and points.
Get the drivers' championship	Get a season's drivers' championship: each driver's place, team, points, wins and gap to the leader.
Get the starting grid	Get a race's starting grid, pole first, with each driver's team and the qualifying time behind the place.
List races	List a season's sessions (races, sprints, qualifying and practice), or a day's, or one Grand Prix's or circuit's, in the order they run, each with its ID, status, laps, distance and fastest lap.
List seasons	List the seasons API-Formula-1 has data for, oldest first, as the years the Season fields take.

Find circuits

Find circuits by name, by Grand Prix or by ID, each with its map, lap length, race distance, lap record, capacity and first Grand Prix.

Inputs

Circuit IDcircuit_idtext: Optional. Only this circuit, by ID, such as 23.
Grand Prixcompetition_idtext: Optional. Only this Grand Prix. Pick one from the list.
Searchsearchtext: Optional. Only names containing this, at least 3 characters.

Outputs

circuitslist: The circuits.
countnumber: How many came back.

Example output

{
  "circuits": [
    {
      "capacity": 60000,
      "competition": {
        "id": 23,
        "location": {
          "city": "Yas Marina, Abou Dabi",
          "country": "United Arab Emirates"
        },
        "name": "Abu Dhabi Grand Prix"
      },
      "first_grand_prix": 2009,
      "id": 23,
      "image": "https://media.api-sports.io/formula-1/circuits/23.png",
      "lap_record": {
        "driver": "Kevin Magnussen",
        "time": "1:25.637",
        "year": 2024
      },
      "laps": 58,
      "length": "5.281 km",
      "name": "Yas Marina Circuit",
      "opened": 2009,
      "owner": "Government of Abu Dhabi",
      "race_distance": "306.183 kms"
    }
  ],
  "count": 1
}

Find drivers

Find drivers by name or ID, each with their nationality, birthday, car number, championships, podiums, career points and the team they drove for each season.

Inputs

Driver IDdriver_idtext: Optional. Only this driver, by ID, such as 25 for Max Verstappen.
Searchsearchtext: Optional. Only names containing this, at least 3 characters.

Outputs

countnumber: How many came back.
driverslist: The drivers.

Example output

{
  "count": 1,
  "drivers": [
    {
      "abbr": "VER",
      "birthdate": "1997-09-30",
      "birthplace": "Hasselt, Belgium",
      "career_points": 3553.5,
      "country": {
        "code": "NL",
        "name": "Netherlands"
      },
      "grands_prix_entered": 244,
      "highest_grid_position": 1,
      "highest_race_finish": {
        "number": 71,
        "position": 1
      },
      "id": 25,
      "image": "https://media.api-sports.io/formula-1/drivers/25.png",
      "name": "Max Verstappen",
      "nationality": "Dutch",
      "number": 3,
      "podiums": 131,
      "teams": [
        {
          "season": 2026,
          "team": {
            "id": 1,
            "logo": "https://media.api-sports.io/formula-1/teams/1.png",
            "name": "Red Bull Racing"
          }
        },
        {
          "season": 2025,
          "team": {
            "id": 1,
            "logo": "https://media.api-sports.io/formula-1/teams/1.png",
            "name": "Red Bull Racing"
          }
        }
      ],
      "world_championships": 4
    }
  ]
}

Find Grands Prix

Find Grands Prix by name, country or city, each with its ID and where it is held. With no filter it lists all of them.

Inputs

Grand Prix IDcompetition_idtext: Optional. Only this Grand Prix, by ID, such as 23.
Searchsearchtext: Optional. Only names containing this, at least 3 characters.
Countrycountrytext: Optional. Only Grands Prix in this country, such as Italy.
Citycitytext: Optional. Only Grands Prix in this city, such as Monza.

Outputs

competitionslist: The Grands Prix.
countnumber: How many came back.

Example output

{
  "competitions": [
    {
      "id": 23,
      "location": {
        "city": "Yas Marina, Abou Dabi",
        "country": "United Arab Emirates"
      },
      "name": "Abu Dhabi Grand Prix"
    }
  ],
  "count": 1
}

Find teams

Find teams by name or ID, each with its base, championships, pole positions, fastest laps, principal, chassis, engine and tyres. With no filter it lists all of them.

Inputs

Teamteam_idtext: Optional. Only this team. Pick one from the list.
Searchsearchtext: Optional. Only names containing this, at least 3 characters.

Outputs

countnumber: How many came back.
teamslist: The teams.

Example output

{
  "count": 1,
  "teams": [
    {
      "base": "Milton Keynes, United Kingdom",
      "chassis": "RB22",
      "director": "Laurent Mekies",
      "engine": "Red Bull Ford",
      "fastest_laps": 100,
      "first_team_entry": 1997,
      "highest_race_finish": {
        "number": 130,
        "position": 1
      },
      "id": 1,
      "logo": "https://media.api-sports.io/formula-1/teams/1.png",
      "name": "Red Bull Racing",
      "pole_positions": 111,
      "president": "Laurent Mekies",
      "technical_manager": "Pierre Wach\u00e9",
      "tyres": "Pirelli",
      "world_championships": 6
    }
  ]
}

Get a race

Get one session by ID: its Grand Prix, circuit, type, status, laps, distance and fastest lap.

Inputs

Session IDrace_idtextRequired: The session's ID, such as 1972 for the 2024 Abu Dhabi Grand Prix's race. List races gives each session's ID.
Time zonetimezonetext: Optional. Give dates and times in this time zone, such as Europe/London or America/New_York. UTC when left empty.

Outputs

circuitobject: The circuit.
competitionobject: A Grand Prix.
datetext: When it starts, with the time zone's offset (ISO 8601).
distancetext: The distance, such as 306.3 Kms.
fastest_lapobject: The session's fastest lap.
idnumber: The session's ID, which results and laps take.
lapsobject: Laps.
seasonnumber: The season.
statustext: Scheduled, Live, Completed, Cancelled or Postponed.
timezonetext: The time zone the date is given in.
typetext: The session, such as Race, Sprint, 1st Qualifying or 2nd Practice.
weathertext: The weather, when the API has it.

Example output

{
  "circuit": {
    "id": 23,
    "image": "https://media.api-sports.io/formula-1/circuits/23.png",
    "name": "Yas Marina Circuit"
  },
  "competition": {
    "id": 23,
    "location": {
      "city": "Yas Marina, Abou Dabi",
      "country": "United Arab Emirates"
    },
    "name": "Abu Dhabi Grand Prix"
  },
  "date": "2024-12-08T13:00:00+00:00",
  "distance": "306.3 Kms",
  "fastest_lap": {
    "driver": {
      "id": 2
    },
    "time": "1:25.637"
  },
  "id": 1972,
  "laps": {
    "current": null,
    "total": 58
  },
  "season": 2024,
  "status": "Completed",
  "timezone": "utc",
  "type": "Race",
  "weather": null
}

Get account status

See the connected key's API-Formula-1 plan, when it renews, and how many of today's requests are used and left. It is free: it never counts against the day.

Inputs

None.

Outputs

activetrue/false: True while the subscription is active.
daily_limitnumber: Requests allowed a day.
plantext: The plan, such as Free.
requests_remainingnumber: Requests left today; the day starts at midnight UTC.
requests_todaynumber: Requests used today.
subscription_endtext: When the plan renews or ends.

Example output

{
  "active": true,
  "daily_limit": 100,
  "plan": "Free",
  "requests_remaining": 88,
  "requests_today": 12,
  "subscription_end": "2027-10-01T00:00:00+00:00"
}

Get fastest laps

Get each driver's fastest lap of a session, fastest first: the lap it was on, its time and the average speed.

Inputs

Session IDrace_idtextRequired: The session's ID, such as 1972 for the 2024 Abu Dhabi Grand Prix's race. List races gives each session's ID.
Driver IDdriver_idtext: Optional. Only this driver, by ID, such as 25 for Max Verstappen.
Teamteam_idtext: Optional. Only this team. Pick one from the list.

Outputs

countnumber: How many came back.
lapslist: The fastest laps, fastest first.
race_idnumber: The session asked about.

Example output

{
  "count": 2,
  "laps": [
    {
      "avg_speed": 222.002,
      "driver": {
        "abbr": "MAG",
        "id": 2,
        "image": "https://media.api-sports.io/formula-1/drivers/2.png",
        "name": "Kevin Magnussen",
        "number": 20
      },
      "lap": 57,
      "position": 1,
      "race_id": 1972,
      "team": {
        "id": 14,
        "logo": "https://media.api-sports.io/formula-1/teams/14.png",
        "name": "Haas F1 Team"
      },
      "time": "1:25.637"
    },
    {
      "avg_speed": 217.828,
      "driver": {
        "abbr": "HAM",
        "id": 20,
        "image": "https://media.api-sports.io/formula-1/drivers/20.png",
        "name": "Lewis Hamilton",
        "number": 44
      },
      "lap": 44,
      "position": 2,
      "race_id": 1972,
      "team": {
        "id": 5,
        "logo": "https://media.api-sports.io/formula-1/teams/5.png",
        "name": "Mercedes-AMG Petronas"
      },
      "time": "1:27.278"
    }
  ],
  "race_id": 1972
}

Get pit stops

Get every pit stop of a race: the driver, their team, which stop it was, the lap and how long it took.

Inputs

Session IDrace_idtextRequired: The session's ID, such as 1972 for the 2024 Abu Dhabi Grand Prix's race. List races gives each session's ID.
Driver IDdriver_idtext: Optional. Only this driver, by ID, such as 25 for Max Verstappen.
Teamteam_idtext: Optional. Only this team. Pick one from the list.

Outputs

countnumber: How many came back.
pit_stopslist: The pit stops.
race_idnumber: The session asked about.

Example output

{
  "count": 2,
  "pit_stops": [
    {
      "driver": {
        "abbr": null,
        "id": 105,
        "image": "https://media.api-sports.io/formula-1/drivers/105.png",
        "name": "Franco Colapinto",
        "number": 43
      },
      "lap": 3,
      "race_id": 1972,
      "stops": 1,
      "team": {
        "id": 12,
        "logo": "https://media.api-sports.io/formula-1/teams/12.png",
        "name": "Williams F1 Team"
      },
      "time": "24.941",
      "total_time": "24.941"
    },
    {
      "driver": {
        "abbr": "PIA",
        "id": 97,
        "image": "https://media.api-sports.io/formula-1/drivers/97.png",
        "name": "Oscar Piastri",
        "number": 81
      },
      "lap": 4,
      "race_id": 1972,
      "stops": 1,
      "team": {
        "id": 2,
        "logo": "https://media.api-sports.io/formula-1/teams/2.png",
        "name": "McLaren Racing"
      },
      "time": "23.582",
      "total_time": "23.582"
    }
  ],
  "race_id": 1972
}

Get race results

Get a session's results in finishing order: each driver's place, time and laps, with their grid slot and pit stops in a race or sprint. There the time is the winner's race time and the others' gap to it, or why they did not finish; in practice and qualifying it is each driver's best lap.

Inputs

Session IDrace_idtextRequired: The session's ID, such as 1972 for the 2024 Abu Dhabi Grand Prix's race. List races gives each session's ID.
Driver IDdriver_idtext: Optional. Only this driver, by ID, such as 25 for Max Verstappen.
Teamteam_idtext: Optional. Only this team. Pick one from the list.

Outputs

countnumber: How many came back.
race_idnumber: The session asked about.
resultslist: The results, in finishing order.

Example output

{
  "count": 2,
  "race_id": 1972,
  "results": [
    {
      "driver": {
        "abbr": "NOR",
        "id": 49,
        "image": "https://media.api-sports.io/formula-1/drivers/49.png",
        "name": "Lando Norris",
        "number": 1
      },
      "gap": null,
      "grid": 1,
      "laps": 58,
      "pits": 1,
      "position": 1,
      "race_id": 1972,
      "team": {
        "id": 2,
        "logo": "https://media.api-sports.io/formula-1/teams/2.png",
        "name": "McLaren Racing"
      },
      "time": "1:26:33.291"
    },
    {
      "driver": {
        "abbr": "SAI",
        "id": 24,
        "image": "https://media.api-sports.io/formula-1/drivers/24.png",
        "name": "Carlos Sainz Jr",
        "number": 55
      },
      "gap": null,
      "grid": 3,
      "laps": 58,
      "pits": 1,
      "position": 2,
      "race_id": 1972,
      "team": {
        "id": 3,
        "logo": "https://media.api-sports.io/formula-1/teams/3.png",
        "name": "Scuderia Ferrari"
      },
      "time": "+5.832"
    }
  ]
}

Get the constructors' championship

Get a season's constructors' championship: each team's place and points. Narrow to one team.

Inputs

SeasonseasonnumberRequired: The season, such as 2024. The free plan reads the 2022 to 2024 seasons.From 1900 to 2100.
Teamteam_idtext: Optional. Only this team. Pick one from the list.

Outputs

countnumber: How many came back.
standingslist: The teams, from first place down.

Example output

{
  "count": 2,
  "standings": [
    {
      "points": 666,
      "position": 1,
      "season": 2024,
      "team": {
        "id": 2,
        "logo": "https://media.api-sports.io/formula-1/teams/2.png",
        "name": "McLaren Racing"
      }
    },
    {
      "points": 652,
      "position": 2,
      "season": 2024,
      "team": {
        "id": 3,
        "logo": "https://media.api-sports.io/formula-1/teams/3.png",
        "name": "Scuderia Ferrari"
      }
    }
  ]
}

Get the drivers' championship

Get a season's drivers' championship: each driver's place, team, points, wins and gap to the leader. Narrow to one driver or team.

Inputs

SeasonseasonnumberRequired: The season, such as 2024. The free plan reads the 2022 to 2024 seasons.From 1900 to 2100.
Driver IDdriver_idtext: Optional. Only this driver, by ID, such as 25 for Max Verstappen.
Teamteam_idtext: Optional. Only this team. Pick one from the list.

Outputs

countnumber: How many came back.
standingslist: The drivers, from first place down.

Example output

{
  "count": 2,
  "standings": [
    {
      "behind": null,
      "driver": {
        "abbr": "VER",
        "id": 25,
        "image": "https://media.api-sports.io/formula-1/drivers/25.png",
        "name": "Max Verstappen",
        "number": 3
      },
      "points": 437,
      "position": 1,
      "season": 2024,
      "team": {
        "id": 1,
        "logo": "https://media.api-sports.io/formula-1/teams/1.png",
        "name": "Red Bull Racing"
      },
      "wins": 9
    },
    {
      "behind": 63,
      "driver": {
        "abbr": "NOR",
        "id": 49,
        "image": "https://media.api-sports.io/formula-1/drivers/49.png",
        "name": "Lando Norris",
        "number": 1
      },
      "points": 374,
      "position": 2,
      "season": 2024,
      "team": {
        "id": 2,
        "logo": "https://media.api-sports.io/formula-1/teams/2.png",
        "name": "McLaren Racing"
      },
      "wins": 4
    }
  ]
}

Get the starting grid

Get a race's starting grid, pole first, with each driver's team and the qualifying time behind the place.

Inputs

Session IDrace_idtextRequired: The session's ID, such as 1972 for the 2024 Abu Dhabi Grand Prix's race. List races gives each session's ID.
Driver IDdriver_idtext: Optional. Only this driver, by ID, such as 25 for Max Verstappen.
Teamteam_idtext: Optional. Only this team. Pick one from the list.

Outputs

countnumber: How many came back.
gridlist: The grid, pole first.
race_idnumber: The session asked about.

Example output

{
  "count": 2,
  "grid": [
    {
      "driver": {
        "abbr": "NOR",
        "id": 49,
        "image": "https://media.api-sports.io/formula-1/drivers/49.png",
        "name": "Lando Norris",
        "number": 1
      },
      "position": 1,
      "race_id": 1972,
      "team": {
        "id": 2,
        "logo": "https://media.api-sports.io/formula-1/teams/2.png",
        "name": "McLaren Racing"
      },
      "time": "1:22.595"
    },
    {
      "driver": {
        "abbr": "PIA",
        "id": 97,
        "image": "https://media.api-sports.io/formula-1/drivers/97.png",
        "name": "Oscar Piastri",
        "number": 81
      },
      "position": 2,
      "race_id": 1972,
      "team": {
        "id": 2,
        "logo": "https://media.api-sports.io/formula-1/teams/2.png",
        "name": "McLaren Racing"
      },
      "time": "1:22.804"
    }
  ],
  "race_id": 1972
}

List races

List a season's sessions (races, sprints, qualifying and practice), or a day's, or one Grand Prix's or circuit's, in the order they run, each with its ID, status, laps, distance and fastest lap. Narrow to one kind of session, such as Race.

Inputs

Seasonseasonnumber: Optional. Only this season, such as 2024. The free plan reads the 2022 to 2024 seasons.From 1900 to 2100.
Dateon_datedate: Optional. Only sessions on this day. The free plan takes only yesterday, today or tomorrow.
Grand Prixcompetition_idtext: Optional. Only this Grand Prix. Pick one from the list.
Circuit IDcircuit_idtext: Optional. Only sessions at this circuit, by ID.
Sessiontypetext: Optional. Only this kind of session, such as Race.One of: Race, Sprint, 1st Qualifying, 2nd Qualifying, 3rd Qualifying, 1st Sprint Shootout, 2nd Sprint Shootout, 3rd Sprint Shootout, 1st Practice, 2nd Practice, 3rd Practice.
Next N sessionsnextnumber: Optional. Only the coming this many sessions, up to 99. Paid plans only: the free plan refuses it.From 1 to 99.
Last N sessionslastnumber: Optional. Only the most recent this many sessions, up to 99. Paid plans only: the free plan refuses it.From 1 to 99.
Time zonetimezonetext: Optional. Give dates and times in this time zone, such as Europe/London or America/New_York. UTC when left empty.

Outputs

countnumber: How many came back.
raceslist: The sessions, in the order they start.

Example output

{
  "count": 1,
  "races": [
    {
      "circuit": {
        "id": 23,
        "image": "https://media.api-sports.io/formula-1/circuits/23.png",
        "name": "Yas Marina Circuit"
      },
      "competition": {
        "id": 23,
        "location": {
          "city": "Yas Marina, Abou Dabi",
          "country": "United Arab Emirates"
        },
        "name": "Abu Dhabi Grand Prix"
      },
      "date": "2024-12-08T13:00:00+00:00",
      "distance": "306.3 Kms",
      "fastest_lap": {
        "driver": {
          "id": 2
        },
        "time": "1:25.637"
      },
      "id": 1972,
      "laps": {
        "current": null,
        "total": 58
      },
      "season": 2024,
      "status": "Completed",
      "timezone": "utc",
      "type": "Race",
      "weather": null
    }
  ]
}

List seasons

List the seasons API-Formula-1 has data for, oldest first, as the years the Season fields take.

Inputs

None.

Outputs

countnumber: How many came back.
seasonslist: The seasons, oldest first.

Example output

{
  "count": 5,
  "seasons": [
    2022,
    2023,
    2024,
    2025,
    2026
  ]
}

ActionsCopy Anchor Link

Find circuitsCopy Anchor Link

Inputs

Outputs

Find driversCopy Anchor Link

Inputs

Outputs

Find Grands PrixCopy Anchor Link

Inputs

Outputs

Find teamsCopy Anchor Link

Inputs

Outputs

Get a raceCopy Anchor Link

Inputs

Outputs

Get account statusCopy Anchor Link

Inputs

Outputs

Get fastest lapsCopy Anchor Link

Inputs

Outputs

Get pit stopsCopy Anchor Link

Inputs

Outputs

Get race resultsCopy Anchor Link

Inputs

Outputs

Get the constructors' championshipCopy Anchor Link

Inputs

Outputs

Get the drivers' championshipCopy Anchor Link

Inputs

Outputs

Get the starting gridCopy Anchor Link

Inputs

Outputs

List racesCopy Anchor Link

Inputs

Outputs

List seasonsCopy Anchor Link

Inputs

Outputs

On this page

Actions

Find circuits

Find drivers

Find Grands Prix

Find teams

Get a race

Get account status

Get fastest laps

Get pit stops

Get race results

Get the constructors' championship

Get the drivers' championship

Get the starting grid

List races

List seasons