# The Space Devs API: List upcoming launches

> Lists upcoming rocket launches worldwide, with launch windows in UTC and local site time. Results can be filtered by company, country or launch site.

Unofficial. Not affiliated with or endorsed by The Space Devs.

- Page: https://fous.com/methods/thespacedevs.com/list-upcoming-launches
- Method: `thespacedevs.com/list_upcoming_launches`, version 1
- Website: thespacedevs.com
- Returns: mission, rocket, company, status, UTC and local windows, site, pad, orbit, links
- 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 |
|---|---|---|---|---|
| `company` | string | no |  | Launch company name, for example SpaceX. |
| `country` | string | no | `"India"` | Launch site country, for example India or United States. |
| `launch_site` | string | no |  | Launch site name or part of it, for example Cape Canaveral. |
| `max_results` | integer | no | `3` | Maximum launches to return, for example 10. Default 10. |

## Output

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

```json
{
  "country": "India",
  "max_results": 3
}
```

Its output:

```json
{
  "launches": [
    {
      "pad": "Satish Dhawan Space Centre Second Launch Pad",
      "rocket": "GSLV Mk. II",
      "status": "To Be Determined",
      "page_link": "https://lldev.thespacedevs.com/2.2.0/launch/20d5676e-111b-40e3-8923-b218c3665ca2/?format=json",
      "image_link": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/gslv2520mk252_image_20240101090337.jpg",
      "launch_site": "Satish Dhawan Space Centre, India",
      "mission_name": "IRNSS-1L (NVS-03)",
      "target_orbit": "Geostationary Transfer Orbit",
      "launch_company": "Indian Space Research Organization",
      "window_end_utc": "2026-10-31T00:00:00+00:00",
      "livestream_link": null,
      "window_end_local": "2026-10-31T05:30:00+05:30",
      "window_start_utc": "2026-10-31T00:00:00+00:00",
      "window_start_local": "2026-10-31T05:30:00+05:30",
      "mission_description": "This is a replacement satellite for the Indian Regional Navigation Satellite System. The constellation will provide India with an alternative to GPS and will be used for military and civilian use. Located at a geosynchronous orbit, the system will be operated by the Indian government."
    },
    {
      "pad": "Satish Dhawan Space Centre First Launch Pad",
      "rocket": "SSLV",
      "status": "To Be Determined",
      "page_link": "https://lldev.thespacedevs.com/2.2.0/launch/e59ff9a4-f72f-4841-8546-3c94346ecdba/?format=json",
      "image_link": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/sslv_image_20220912001724.jpeg",
      "launch_site": "Satish Dhawan Space Centre, India",
      "mission_name": "AayulSAT-1A & others",
      "target_orbit": "Low Earth Orbit",
      "launch_company": "Indian Space Research Organization",
      "window_end_utc": "2026-10-31T00:00:00+00:00",
      "livestream_link": null,
      "window_end_local": "2026-10-31T05:30:00+05:30",
      "window_start_utc": "2026-10-31T00:00:00+00:00",
      "window_start_local": "2026-10-31T05:30:00+05:30",
      "mission_description": "Ride-share launch of multiple satellites, including the in-orbit refueling demonstration satellite AayulSAT-1A from OrbitAID Aerospace. Other payload's identities TBD."
    },
    {
      "pad": "Satish Dhawan Space Centre Second Launch Pad",
      "rocket": "Launch Vehicle Mark-3 (GSLV Mk III)",
      "status": "To Be Determined",
      "page_link": "https://lldev.thespacedevs.com/2.2.0/launch/dfac5ab7-7017-454f-b6cf-eeed277a97b5/?format=json",
      "image_link": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/gslv2520mk2520iii_image_20190604000938.jpg",
      "launch_site": "Satish Dhawan Space Centre, India",
      "mission_name": "Gaganyaan-1",
      "target_orbit": "Low Earth Orbit",
      "launch_company": "Indian Space Research Organization",
      "window_end_utc": "2026-11-30T00:00:00+00:00",
      "livestream_link": null,
      "window_end_local": "2026-11-30T05:30:00+05:30",
      "window_start_utc": "2026-11-30T00:00:00+00:00",
      "window_start_local": "2026-11-30T05:30:00+05:30",
      "mission_description": "First uncrewed orbital test flight of the Gaganyaan capsule."
    }
  ]
}
```

## 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":"thespacedevs.com/list_upcoming_launches","input":{"country":"India","max_results":3}}'
```

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 rocket launches are scheduled next from Cape Canaveral, and when are their UTC windows?
- Show me the next 8 upcoming SpaceX launches with their pads and orbits.
- Any upcoming launches from India in the coming weeks? Include mission names and local launch times.
- List the next 15 scheduled orbital launches worldwide from thespacedevs.com, including status and links.
- Which launches from Vandenberg are on the schedule, and what company is flying each mission?

## Input schema

```json
{
  "type": "object",
  "properties": {
    "company": {
      "type": "string",
      "description": "Launch company name, for example SpaceX."
    },
    "country": {
      "type": "string",
      "description": "Launch site country, for example India or United States."
    },
    "launch_site": {
      "type": "string",
      "description": "Launch site name or part of it, for example Cape Canaveral."
    },
    "max_results": {
      "type": "integer",
      "default": 10,
      "maximum": 50,
      "minimum": 1,
      "description": "Maximum launches to return, for example 10."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "launches"
  ],
  "properties": {
    "launches": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "pad": {
            "type": "string"
          },
          "rocket": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "page_link": {
            "type": "string"
          },
          "image_link": {
            "type": "string"
          },
          "launch_site": {
            "type": "string"
          },
          "mission_name": {
            "type": "string"
          },
          "target_orbit": {
            "type": "string"
          },
          "launch_company": {
            "type": "string"
          },
          "window_end_utc": {
            "type": "string"
          },
          "livestream_link": {
            "type": "string"
          },
          "window_end_local": {
            "type": "string"
          },
          "window_start_utc": {
            "type": "string"
          },
          "window_start_local": {
            "type": "string"
          },
          "mission_description": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

## See more

- [The Space Devs API: Get launch by mission or rocket name](https://fous.com/methods/thespacedevs.com/get-launch.md): Finds a launch by mission or rocket name. Picks the next upcoming match, otherwise the most recent past match, and returns its details.
- [Nike API: List upcoming SNKRS releases](https://fous.com/methods/nike.com/list-upcoming-releases.md): Lists upcoming or in-stock Nike SNKRS sneaker releases for a country. Each release has its local launch time and price.
- [NASA API: Get ISS sightings](https://fous.com/methods/nasa.gov/get-iss-sightings.md): Finds upcoming International Space Station sightings for a city in NASA's city list, with local start times, visibility and sky directions. Cities without scheduled passes return an empty list.
- [themoviedb.org API: List upcoming theatrical movies in a country](https://fous.com/methods/themoviedb.org/list-upcoming-movies.md): Lists movies scheduled for theatrical release in a country over the coming three weeks, soonest first, from TMDB's country-specific release calendar, with genres, overview and user score.
- [Product Hunt API: List daily launches](https://fous.com/methods/producthunt.com/list-launches.md): Lists featured launches in Product Hunt's daily leaderboard order for a given US Pacific day, with each product's website when its public page shows one.
- [UFC API: List events](https://fous.com/methods/ufc.com/list-events.md): Lists upcoming or past UFC events with fight cards, venue, start time and completed bout results, or returns one event by name. Upcoming events come soonest first and past events newest first.
- [Greenhouse API: List company jobs](https://fous.com/methods/boards.greenhouse.io/list-company-jobs.md): Lists open jobs on a company's Greenhouse job board, with optional department and location filters.
- [Flightradar24 API: List airport flights](https://fous.com/methods/flightradar24.com/list-airport-flights.md): Lists upcoming departures or arrivals at an airport from the Flightradar24 public airport board, with local times, airline, route, status and aircraft.
- [All The Space Devs methods](https://fous.com/methods/thespacedevs.com.md)
