# Formula 1 API: Get race results

> Returns the main-race finishing order and fastest lap for a Formula 1 Grand Prix. Defaults to the most recent completed race in the current season.

Unofficial. Not affiliated with or endorsed by Formula 1.

- Page: https://fous.com/methods/formula1.com/get-race-results
- Method: `formula1.com/get_race_results`, version 1
- Website: formula1.com
- Returns: Grand Prix name, date, circuit, fastest lap, finishing order with points
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `year` | integer | no |  | Season year, such as 2025. Omit for the current season. |
| `grand_prix` | string | no |  | Grand Prix name, circuit or host country, such as Monaco, Silverstone or Japan. Omit for the latest completed race. Default "". |

## Output

From a run on Oct 23, 2026, shortened. Its input:

```json
{}
```

Its output:

```json
{
  "date": "2026-10-11",
  "link": "https://www.formula1.com/en/results/2026/races/1296/singapore/race-result",
  "circuit": "Marina Bay Street Circuit",
  "results": [
    {
      "team": "Red Bull Racing",
      "driver": "Max Verstappen",
      "points": 25,
      "position": "1",
      "car_number": 3,
      "time_or_gap": "1:42:00.785",
      "laps_completed": 62
    },
    {
      "team": "Ferrari",
      "driver": "Charles Leclerc",
      "points": 18,
      "position": "2",
      "car_number": 16,
      "time_or_gap": "+7.335s",
      "laps_completed": 62
    },
    {
      "team": "Mercedes",
      "driver": "Kimi Antonelli",
      "points": 15,
      "position": "3",
      "car_number": 12,
      "time_or_gap": "+24.573s",
      "laps_completed": 62
    }
  ],
  "grand_prix": "Singapore Grand Prix",
  "fastest_lap": {
    "team": "Ferrari",
    "driver": "Charles Leclerc",
    "lap_time": "1:35.202"
  }
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"formula1.com/get_race_results","input":{}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- Who won the Monaco Grand Prix in 2024 and what was the full finishing order?
- Latest F1 race result, fastest lap and points for each driver
- Show me the Japan GP 2025 results with points scored
- What was the fastest lap at Silverstone last season?
- formula1.com results for the most recent Grand Prix, finishing positions please

## Input schema

```json
{
  "type": "object",
  "required": [],
  "properties": {
    "year": {
      "type": "integer",
      "description": "Season year, such as 2025. Omit for the current season."
    },
    "grand_prix": {
      "type": "string",
      "default": "",
      "description": "Grand Prix name, circuit or host country, such as Monaco, Silverstone or Japan. Omit for the latest completed race."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "grand_prix",
    "date",
    "circuit",
    "fastest_lap",
    "link",
    "results"
  ],
  "properties": {
    "date": {
      "type": "string",
      "format": "date"
    },
    "link": {
      "type": "string"
    },
    "circuit": {
      "type": [
        "string",
        "null"
      ]
    },
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "position",
          "driver",
          "car_number",
          "team",
          "laps_completed",
          "time_or_gap",
          "points"
        ],
        "properties": {
          "team": {
            "type": "string"
          },
          "driver": {
            "type": "string"
          },
          "points": {
            "type": "number"
          },
          "position": {
            "type": "string"
          },
          "car_number": {
            "type": "integer"
          },
          "time_or_gap": {
            "type": "string"
          },
          "laps_completed": {
            "type": [
              "integer",
              "null"
            ]
          }
        }
      }
    },
    "grand_prix": {
      "type": "string"
    },
    "fastest_lap": {
      "type": [
        "object",
        "null"
      ],
      "required": [
        "driver",
        "team",
        "lap_time"
      ],
      "properties": {
        "team": {
          "type": "string"
        },
        "driver": {
          "type": "string"
        },
        "lap_time": {
          "type": "string"
        }
      }
    }
  }
}
```

## See more

- [Formula 1 API: Get championship standings](https://fous.com/methods/formula1.com/get-standings.md): Gets Formula 1 drivers' and teams' championship standings for a season, with the last completed race. Teams' standings begin in 1958.
- [Formula 1 API: Get race calendar](https://fous.com/methods/formula1.com/get-race-calendar.md): Gets a Formula 1 season calendar with venues, sprint weekends, status, and session start times in circuit local time or a chosen city or IANA time zone.
- [atptour.com API: Get ATP tournament results](https://fous.com/methods/atptour.com/get-tournament-results.md): Gets singles match results round by round for an ATP tournament and year, including the champion, dates, surface and category. Without a year it uses the most recent listed edition.
- [Premier League API: Get league table](https://fous.com/methods/premierleague.com/get-league-table.md): Gets the Premier League table for the current season or a chosen season, with each club's last five league results.
- [parkrun.com API: Get parkrun event results](https://fous.com/methods/parkrun.com/get-event-results.md): Gets the latest or a dated public parkrun event result, with finishers in position order. If a name matches several events, the closest directory name match is used.
- [Premier League API: Get fixtures and results](https://fous.com/methods/premierleague.com/get-fixtures-and-results.md): Gets Premier League fixtures and results in a date range, with kickoff times in your chosen time zone. Returns up to 380 matches.
- [FIFA API: Get world ranking](https://fous.com/methods/fifa.com/get-world-ranking.md): Gets the latest official FIFA men's or women's national-team ranking, with points and movement since the previous ranking. Unranked teams are excluded.
- [ElectionGuide API: Get election results](https://fous.com/methods/electionguide.org/get-election-results.md): Gets a country's most recent held national election or referendum on ElectionGuide, optionally for a year and election type, with turnout and published candidate, party or option results.
- [All Formula 1 methods](https://fous.com/methods/formula1.com.md)
