# Formula 1 API: Get race calendar

> 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.

Unofficial. Not affiliated with or endorsed by Formula 1.

- Page: https://fous.com/methods/formula1.com/get-race-calendar
- Method: `formula1.com/get_race_calendar`, version 1
- Website: formula1.com
- Returns: season, races with round, grand prix, circuit, city, country, dates, sprint flag, status, sessions, link
- 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 | `2026` | Season year, such as 2026. Leave blank for the current season. |
| `time_zone` | string | no |  | City or IANA time zone for session start times, such as New York or America/New_York. Leave blank for circuit local time. Default "local". |

## Output

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

```json
{
  "year": 2026
}
```

Its output:

```json
{
  "races": [
    {
      "city": "Melbourne",
      "link": "https://www.formula1.com/en/racing/2026/australia",
      "round": 1,
      "status": "completed",
      "circuit": "Albert Park Grand Prix Circuit",
      "country": "Australia",
      "sessions": [
        {
          "name": "Practice 1",
          "start_time": "2026-03-06T12:30:00+11:00"
        },
        {
          "name": "Practice 2",
          "start_time": "2026-03-06T16:00:00+11:00"
        },
        {
          "name": "Practice 3",
          "start_time": "2026-03-07T12:30:00+11:00"
        }
      ],
      "grand_prix": "Australian Grand Prix",
      "sprint_weekend": false,
      "weekend_end_date": "2026-03-08",
      "weekend_start_date": "2026-03-06"
    },
    {
      "city": "Shanghai",
      "link": "https://www.formula1.com/en/racing/2026/china",
      "round": 2,
      "status": "completed",
      "circuit": "Shanghai International Circuit",
      "country": "China",
      "sessions": [
        {
          "name": "Practice 1",
          "start_time": "2026-03-13T11:30:00+08:00"
        },
        {
          "name": "Sprint Qualifying",
          "start_time": "2026-03-13T15:30:00+08:00"
        },
        {
          "name": "Sprint",
          "start_time": "2026-03-14T11:00:00+08:00"
        }
      ],
      "grand_prix": "Chinese Grand Prix",
      "sprint_weekend": true,
      "weekend_end_date": "2026-03-15",
      "weekend_start_date": "2026-03-13"
    },
    {
      "city": "Suzuka",
      "link": "https://www.formula1.com/en/racing/2026/japan",
      "round": 3,
      "status": "completed",
      "circuit": "Suzuka Circuit",
      "country": "Japan",
      "sessions": [
        {
          "name": "Practice 1",
          "start_time": "2026-03-27T11:30:00+09:00"
        },
        {
          "name": "Practice 2",
          "start_time": "2026-03-27T15:00:00+09:00"
        },
        {
          "name": "Practice 3",
          "start_time": "2026-03-28T11:30:00+09:00"
        }
      ],
      "grand_prix": "Japanese Grand Prix",
      "sprint_weekend": false,
      "weekend_end_date": "2026-03-29",
      "weekend_start_date": "2026-03-27"
    }
  ],
  "season": 2026
}
```

## 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_calendar","input":{"year":2026}}'
```

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

- What is the F1 schedule for 2026 with session times converted to New York time?
- Show me every Grand Prix on the 2025 calendar, marking which weekends have sprint races.
- Which circuits are hosting races next season and in what countries?
- I need the Formula 1 race dates and session start times in Tokyo time for this year's season.
- List the upcoming formula1.com races for 2027 with round numbers, cities, and status.

## Input schema

```json
{
  "type": "object",
  "properties": {
    "year": {
      "type": "integer",
      "maximum": 2100,
      "minimum": 1950,
      "description": "Season year, such as 2026. Leave blank for the current season."
    },
    "time_zone": {
      "type": "string",
      "default": "local",
      "description": "City or IANA time zone for session start times, such as New York or America/New_York. Leave blank for circuit local time."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "season",
    "races"
  ],
  "properties": {
    "races": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "city": {
            "type": [
              "string",
              "null"
            ]
          },
          "link": {
            "type": "string"
          },
          "round": {
            "type": "integer"
          },
          "status": {
            "enum": [
              "upcoming",
              "completed",
              "cancelled"
            ],
            "type": "string"
          },
          "circuit": {
            "type": [
              "string",
              "null"
            ]
          },
          "country": {
            "type": [
              "string",
              "null"
            ]
          },
          "sessions": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "name": {
                  "type": "string"
                },
                "start_time": {
                  "type": "string"
                }
              }
            }
          },
          "grand_prix": {
            "type": "string"
          },
          "sprint_weekend": {
            "type": "boolean"
          },
          "weekend_end_date": {
            "type": [
              "string",
              "null"
            ]
          },
          "weekend_start_date": {
            "type": [
              "string",
              "null"
            ]
          }
        }
      }
    },
    "season": {
      "type": "integer"
    }
  }
}
```

## See more

- [Formula 1 API: Get race results](https://fous.com/methods/formula1.com/get-race-results.md): 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.
- [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.
- [PGA Tour API: Get schedule](https://fous.com/methods/pgatour.com/get-schedule.md): Returns the PGA Tour season schedule for a year, with dates, venue, purse, status, winners and defending champions.
- [ESPN API: Get team schedule](https://fous.com/methods/espn.com/get-team-schedule.md): Returns a team's past results and upcoming games for a season on ESPN, with opponents, local start times, scores, broadcasts and venues. Soccer fixtures include all competitions shown for the team.
- [FIFA API: Get tournament matches](https://fous.com/methods/fifa.com/get-tournament-matches.md): Gets FIFA tournament matches in kick-off order, with scores, stages, teams and venues. The tournament name must include a year.
- [Fandango API: Get theater showtimes](https://fous.com/methods/fandango.com/get-theater-showtimes.md): Gets a movie theater's films and showtimes on Fandango for a date, from the theater's name and its city or ZIP code. Each film lists its rating, runtime and showtimes grouped by format with ticket links; a date without listed showtimes returns no films.
- [Time and Date API: Convert time between cities](https://fous.com/methods/timeanddate.com/convert-time-between-cities.md): Converts a meeting time in one city to local times in other cities, with time zones and 09:00-17:00 working-hours status. Supports dates from 1970 to 2030; ambiguous clock-change times use the first occurrence.
- [NBA API: Get scores](https://fous.com/methods/nba.com/get-scores.md): Gets NBA games for a date or up to seven days, using the NBA games calendar in US Eastern time. Each game has its score, status, start time, TV channels and venue.
- [All Formula 1 methods](https://fous.com/methods/formula1.com.md)
