# Launch Library 2

> Track spaceflight with Launch Library 2 from The Space Devs: upcoming and past rocket launches from SpaceX, NASA, Rocket Lab and more, dockings, spacewalks and other events, astronauts, space stations, rockets, spacecraft and launch sites.

App · 20 actions. Web page: https://docs.lodol.com/docs/integrations/launch-library

## Actions

### Check remaining requests

How many of the 15 requests an hour Launch Library 2 allows are left. This check doesn't use one.

**Inputs**: None.

**Outputs**

- `message` (text): The same, in a sentence.
- `period_seconds` (number): The length of the period, in seconds.
- `request_limit` (number): Requests allowed each hour.
- `requests_remaining` (number): Requests left.
- `requests_used` (number): Requests used in the last hour.
- `seconds_until_available` (number): Seconds until a request is allowed again; 0 when one is now.

**Example output**

```json
{
  "message": "14 of 15 requests left this hour.",
  "period_seconds": 3600,
  "request_limit": 15,
  "requests_remaining": 14,
  "requests_used": 1,
  "seconds_until_available": 0
}
```

### Get agency details

One agency or company, with its launch record, landings, rockets and spacecraft.

**Inputs**

- Agency (`agency`, text, required): The agency or company. Pick one, or enter an agency ID from List agencies.

**Outputs**

- `abbreviation` (text): Its short name, such as NASA or SpX.
- `administrator` (text): Who runs it.
- `attempted_landings` (number): Booster landings it has attempted.
- `consecutive_successful_launches` (number): Its current run of successes.
- `country` (text): Its country.
- `country_code` (text): That country's two-letter code.
- `description` (text): About the agency.
- `failed_launches` (number): Of those, how many failed.
- `featured` (true/false): Whether Launch Library 2 counts it among the major agencies.
- `founding_year` (number): The year it was founded.
- `id` (number): The agency's ID, for Get agency details.
- `image_url` (text): A picture for it.
- `info_url` (text): Its website.
- `logo_url` (text): Its logo.
- `name` (text): The agency or company.
- `pending_launches` (number): Launches it has planned.
- `rocket_list` (list): Its rockets, by name.
- `rockets` (text): The rocket families it builds or flies.
- `spacecraft` (text): The spacecraft it builds or flies.
- `spacecraft_list` (list): Its spacecraft, by name.
- `successful_landings` (number): Boosters it has landed.
- `successful_launches` (number): Of those, how many succeeded.
- `total_launch_count` (number): Launches it has made.
- `type` (text): Government, Commercial, Multinational, Educational or Private.
- `wiki_url` (text): Its Wikipedia page.

**Example output**

```json
{
  "abbreviation": "SpX",
  "administrator": "CEO: Elon Musk",
  "attempted_landings": 711,
  "consecutive_successful_launches": 223,
  "country": "United States of America",
  "country_code": "US",
  "description": "Space Exploration Technologies Corp., known as SpaceX, is an American aerospace manufacturer and space transport services company headquartered in Hawthorne, California. It was founded in 2002 by entrepreneur Elon Musk\u2026",
  "failed_launches": 15,
  "featured": true,
  "founding_year": 2002,
  "id": 121,
  "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/falcon_9_image_20230807133459.jpeg",
  "info_url": "https://www.spacex.com/",
  "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/spacex_logo_20220826094919.png",
  "name": "SpaceX",
  "pending_launches": 135,
  "rocket_list": [
    "Falcon 1",
    "Falcon 9 Block 5",
    "Falcon 9 v1.0"
  ],
  "rockets": "Falcon | Starship",
  "spacecraft": "Dragon",
  "spacecraft_list": [
    "Cargo Dragon 2",
    "Crew Dragon 2",
    "Dragon 1"
  ],
  "successful_landings": 683,
  "successful_launches": 723,
  "total_launch_count": 738,
  "type": "Commercial",
  "wiki_url": "https://en.wikipedia.org/wiki/SpaceX"
}
```

### Get astronaut details

One astronaut, with their biography, time in space and every flight.

**Inputs**

- Astronaut ID (`astronaut_id`, number, required): The astronaut's ID, from List astronauts. At least 1.

**Outputs**

- `age` (number): Their age.
- `agency` (text): The agency they fly for.
- `agency_id` (number): That agency's ID.
- `bio` (text): A short biography.
- `date_of_birth` (text): Their date of birth.
- `date_of_death` (text): Their date of death, if they have died.
- `days_in_space` (number): Total days they have spent in space.
- `first_flight` (text): When they first flew (UTC).
- `flights` (list): The launches they flew on.
- `flights_count` (number): Flights to space.
- `id` (number): The astronaut's ID, for Get astronaut details.
- `image_url` (text): Their portrait.
- `in_space` (true/false): Whether they are in space now.
- `last_flight` (text): When they last flew (UTC).
- `name` (text): Their name.
- `nationality` (text): Their nationality.
- `nationality_code` (text): That country's two-letter code.
- `spacewalk_hours` (number): Total hours of spacewalks.
- `spacewalks_count` (number): Spacewalks.
- `status` (text): Active, Retired, In-Training, Deceased…
- `wiki_url` (text): Their Wikipedia page.

**Example output**

```json
{
  "age": 50,
  "agency": "National Aeronautics and Space Administration",
  "agency_id": 44,
  "bio": "Anil Menon is a US Air Force lieutenant colonel from Minneapolis, Minnesota. He was SpaceX\u2019s first flight surgeon, helping to launch the company\u2019s first humans to space during NASA\u2019s SpaceX Demo-2 mission and building a\u2026",
  "date_of_birth": "1976-01-01",
  "date_of_death": null,
  "days_in_space": 92.4,
  "first_flight": "2026-07-14T14:47:43Z",
  "flights": [
    {
      "launch_id": "a556b963-0f36-4660-95a8-fdffdba653e2",
      "launch_time": "2026-07-14T14:47:43Z",
      "name": "Soyuz 2.1a | Soyuz MS-29"
    }
  ],
  "flights_count": 1,
  "id": 713,
  "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/anil_menon_image_20211206185413.jpg",
  "in_space": true,
  "last_flight": "2026-07-14T14:47:43Z",
  "name": "Anil Menon",
  "nationality": "United States of America",
  "nationality_code": "US",
  "spacewalk_hours": 19.5,
  "spacewalks_count": 3,
  "status": "Active",
  "wiki_url": "https://en.wikipedia.org/wiki/Anil_Menon_(astronaut)"
}
```

### Get event details

One event, with the launches, agencies and stations involved.

**Inputs**

- Event ID (`event_id`, number, required): The event's ID, from List upcoming events. At least 1.

**Outputs**

- `agencies` (list): The agencies involved.
- `date` (text): When it happens (UTC, ISO 8601).
- `date_precision` (text): How exact the date is: Minute, Hour, Day…
- `description` (text): What happens.
- `id` (number): The event's ID, for Get event details.
- `image_url` (text): A picture for it.
- `info_url` (text): The main page about it.
- `last_updated` (text): When this event's record last changed (UTC).
- `launches` (list): Launches it is part of.
- `location` (text): Where it happens.
- `name` (text): The event, such as 'SpaceX CRS-35 Dragon Docking'.
- `programs` (list): The programs it belongs to.
- `space_stations` (list): The space stations involved.
- `type` (text): The kind of event: Docking, EVA, Static Fire, Press Event…
- `video_url` (text): The main webcast or video.
- `webcast_live` (true/false): Whether a webcast is live now.

**Example output**

```json
{
  "agencies": [
    "European Space Agency",
    "National Aeronautics and Space Administration",
    "Russian Federal Space Agency (ROSCOSMOS)"
  ],
  "date": "2026-10-15T19:30:00Z",
  "date_precision": "Minute",
  "description": "After more than seven months aboard the International Space Station, NASA\u2019s SpaceX Crew-12 mission safely splashed down in the Pacific Ocean off the coast of Los Angeles. The crew members will discuss their science\u2026",
  "id": 1563,
  "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/crew-12_spacex__image_20260126082450.png",
  "info_url": "https://www.nasa.gov/news-release/nasas-spacex-crew-12-splashes-down-sets-briefing-to-discuss-mission/",
  "last_updated": "2026-10-09T06:39:23Z",
  "launches": [
    {
      "id": "862b54e3-7bf8-48e5-8cd1-d77257d5fde9",
      "name": "Falcon 9 Block 5 | Crew-12"
    }
  ],
  "location": "Johnson Space Center, Houston, TX, USA",
  "name": "SpaceX Crew-12 Post-Flight News Conference",
  "programs": [
    "Commercial Crew Program"
  ],
  "space_stations": [],
  "type": "Press Event",
  "video_url": null,
  "webcast_live": false
}
```

### Get launch details

Everything about one launch: its crew, webcast, mission, pad, weather concerns and the latest updates.

**Inputs**

- Launch ID (`launch_id`, text, required): The launch's ID, from a launch list or search step, such as 18441371-8b2e-457c-afb5-1ec1b11ab630.

**Outputs**

- `agencies` (list): The agencies behind the mission.
- `country` (text): The country it launches from.
- `country_code` (text): That country's two-letter code.
- `crew` (list): The people on board, for a crewed launch.
- `failure_reason` (text): What went wrong, for a failed launch.
- `id` (text): The launch's ID, for Get launch details.
- `image_url` (text): A picture of the rocket or mission.
- `info_url` (text): The main page about the launch.
- `last_updated` (text): When this launch's record last changed (UTC).
- `launch_provider` (text): The company or agency launching it.
- `launch_provider_id` (number): The launch provider's agency ID.
- `launch_site` (text): The launch site the pad is at.
- `launch_site_id` (number): The launch site's ID.
- `launch_time` (text): When it launches or launched (UTC, ISO 8601).
- `mission` (text): The mission's name.
- `mission_description` (text): What the mission is for.
- `mission_type` (text): The kind of mission, such as Communications or Human Exploration.
- `name` (text): Rocket and mission, such as 'Falcon 9 Block 5 | Crew-13'.
- `orbit` (text): The target orbit, such as Low Earth Orbit.
- `orbital_launch_attempt_count` (number): Which orbital launch attempt this is, worldwide, ever.
- `pad` (text): The launch pad.
- `pad_map_url` (text): The pad on a map.
- `probability` (number): The chance of good launch weather, in percent, when known.
- `programs` (list): The programs it belongs to, such as Artemis.
- `provider_launch_count_this_year` (number): Which of the provider's launches this year this is.
- `rocket` (text): The rocket, such as Falcon 9 Block 5.
- `rocket_id` (number): The rocket's ID.
- `status` (text): Go for Launch, To Be Determined, Launch Successful and so on.
- `status_abbreviation` (text): The status in short: Go, TBD, TBC, Success, Failure.
- `time_precision` (text): How exact launch_time is: Second, Minute, Hour, Day, Month…
- `updates` (list): The editors' latest notes on the launch, newest first.
- `weather_concerns` (text): Weather that could delay it, when reported.
- `webcast_live` (true/false): Whether a webcast is live now.
- `webcast_url` (text): The main webcast or video.
- `window_end` (text): When the launch window closes (UTC).
- `window_start` (text): When the launch window opens (UTC).

**Example output**

```json
{
  "agencies": [
    "Canadian Space Agency",
    "National Aeronautics and Space Administration",
    "Russian Federal Space Agency (ROSCOSMOS)"
  ],
  "country": "United States of America",
  "country_code": "US",
  "crew": [
    {
      "agency": "National Aeronautics and Space Administration",
      "astronaut_id": 582,
      "name": "Jessica Watkins",
      "role": "Spacecraft Commander"
    },
    {
      "agency": "Canadian Space Agency",
      "astronaut_id": 642,
      "name": "Joshua Kutryk",
      "role": "Flight Engineer"
    },
    {
      "agency": "National Aeronautics and Space Administration",
      "astronaut_id": 710,
      "name": "Luke Delaney",
      "role": "Pilot"
    }
  ],
  "failure_reason": null,
  "id": "18441371-8b2e-457c-afb5-1ec1b11ab630",
  "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/falcon2520925_image_20220301072106.jpeg",
  "info_url": "https://www.spacex.com/launches/crew13",
  "last_updated": "2026-10-15T01:40:30Z",
  "launch_provider": "SpaceX",
  "launch_provider_id": 121,
  "launch_site": "Cape Canaveral SFS, FL, USA",
  "launch_site_id": 12,
  "launch_time": "2026-10-01T15:10:06Z",
  "mission": "Crew-13",
  "mission_description": "SpaceX Crew-13 is the thirteenth crewed operational flight of a Crew Dragon spacecraft to the International Space Station as part of NASA's Commercial Crew Program.",
  "mission_type": "Human Exploration",
  "name": "Falcon 9 Block 5 | Crew-13",
  "orbit": "Low Earth Orbit",
  "orbital_launch_attempt_count": 7407,
  "pad": "Space Launch Complex 40",
  "pad_map_url": "https://www.google.com/maps?q=28.56194122,-80.57735736",
  "probability": 60,
  "programs": [
    "Commercial Crew Program",
    "International Space Station"
  ],
  "provider_launch_count_this_year": 114,
  "rocket": "Falcon 9 Block 5",
  "rocket_id": 164,
  "status": "Launch Successful",
  "status_abbreviation": "Success",
  "time_precision": "Second",
  "updates": [
    {
      "comment": "Launch success, spacecraft in operation.",
      "created_on": "2026-10-01T15:29:00Z",
      "info_url": "https://x.com/i/broadcasts/1qxvvepEVdRxB"
    },
    {
      "comment": "Liftoff.",
      "created_on": "2026-10-01T15:10:00Z",
      "info_url": "https://x.com/i/broadcasts/1qxvvepEVdRxB"
    },
    {
      "comment": "Updated launch weather, 60% GO.",
      "created_on": "2026-10-01T13:51:00Z",
      "info_url": "https://x.com/spacex/status/2105653383876972884"
    }
  ],
  "weather_concerns": "Cumulus Cloud Rule, Flight Through Precipitation, Thick Cloud Layers Rule",
  "webcast_live": false,
  "webcast_url": "https://www.youtube.com/watch?v=Mkf_wAw8kLc",
  "window_end": "2026-10-01T15:10:06Z",
  "window_start": "2026-10-01T15:10:06Z"
}
```

### Get space station details

One space station, with the crew count, current expeditions and the spacecraft docked now.

**Inputs**

- Space station (`space_station`, text, required): The station. Another station's ID from List space stations works too. One of: `4` (International Space Station), `18` (Tiangong space station). Default: `4`.

**Outputs**

- `crew_on_board` (number): People aboard now.
- `current_expeditions` (list): The expeditions aboard now.
- `deorbited` (text): When it came down, if it has.
- `description` (text): About the station.
- `docked_vehicles` (list): The spacecraft docked now.
- `docked_vehicles_count` (number): Spacecraft docked now.
- `founded` (text): When its first part was launched.
- `height_m` (number): Its height, in metres.
- `id` (number): The station's ID, for Get space station details.
- `image_url` (text): A picture of it.
- `mass_tonnes` (number): Its mass, in tonnes.
- `name` (text): The station.
- `orbit` (text): Its orbit.
- `owners` (list): The agencies that own it.
- `status` (text): Active, De-Orbited or Decommissioned.
- `type` (text): Government, Commercial and so on.
- `volume_m3` (number): Its pressurised volume, in cubic metres.
- `width_m` (number): Its width, in metres.

**Example output**

```json
{
  "crew_on_board": 7,
  "current_expeditions": [
    "Expedition 75"
  ],
  "deorbited": null,
  "description": "The International Space Station (ISS) is a space station, or a habitable artificial satellite, in low Earth orbit. Its first component was launched into orbit in 1998, with the first long-term residents arriving in\u2026",
  "docked_vehicles": [
    {
      "docked_at": "2026-10-01T23:05:00Z",
      "port": "Harmony forward",
      "vehicle": "Crew Dragon Grace"
    },
    {
      "docked_at": "2026-04-28T00:00:48Z",
      "port": "Zvezda aft",
      "vehicle": "Progress MS-34"
    },
    {
      "docked_at": "2026-09-19T13:44:20Z",
      "port": "Poisk zenith",
      "vehicle": "Progress MS-35"
    }
  ],
  "docked_vehicles_count": 4,
  "founded": "1998-11-20",
  "height_m": 72.8,
  "id": 4,
  "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/international2520space2520station_image_20190220215716.jpeg",
  "mass_tonnes": 419.7,
  "name": "International Space Station",
  "orbit": "Low Earth Orbit",
  "owners": [
    "Canadian Space Agency",
    "European Space Agency",
    "Japan Aerospace Exploration Agency"
  ],
  "status": "Active",
  "type": "Government",
  "volume_m3": 931,
  "width_m": 108.5
}
```

### List agencies

Space agencies and companies, such as NASA, ESA, SpaceX and Rocket Lab, alphabetically.

**Inputs**

- Search (`search`, text): Words to look for in the agency's name.
- Type (`agency_type`, text): Only agencies of this kind. Leave empty for all. One of: `1` (Government), `3` (Commercial), `2` (Multinational), `4` (Educational), `5` (Private).
- Country (`country`, text): Only those in this country. Leave empty for all. One of: `USA` (United States), `CHN` (China), `RUS` (Russia), `FRA` (France), `GUF` (French Guiana), `JPN` (Japan), `IND` (India), `GBR` (United Kingdom), `DEU` (Germany), `ITA` (Italy), and 20 more.
- Major agencies only (`featured_only`, true/false): Only the agencies Launch Library 2 features. Default: `false`.
- Max results (`limit`, number): Return at most this many. Any number up to 100 uses one request. From 1 to 100. Default: `10`.
- Skip (`offset`, number): Skip this many results first, to get the next page. From 0 to 100000. Default: `0`.

**Outputs**

- `agencies` (list): The agencies.
- `count` (number): How many agencies this step returned.
- `has_more` (true/false): Whether more match than were returned; use Skip for the next page.
- `total` (number): How many agencies match in all.

**Example output**

```json
{
  "agencies": [
    {
      "abbreviation": "CASC",
      "administrator": "Chairman & President: Lei Fanpei",
      "country": "China",
      "country_code": "CN",
      "description": "The China Aerospace Science and Technology Corporation (CASC) is the main contractor for the Chinese space program. It is state-owned and has a number of subordinate entities which design, develop and manufacture a\u2026",
      "featured": true,
      "founding_year": 1999,
      "id": 88,
      "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_image_20191228094408.jpeg",
      "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_logo_20220826093937.png",
      "name": "China Aerospace Science and Technology Corporation",
      "rockets": "Long March",
      "spacecraft": null,
      "type": "Government"
    }
  ],
  "count": 1,
  "has_more": true,
  "total": 7
}
```

### List astronauts

Astronauts, cosmonauts and taikonauts, alphabetically. Turn on In space now to see who is in orbit.

**Inputs**

- Search (`search`, text): Words to look for in the astronaut's name.
- In space now (`in_space_only`, true/false): Only people in space right now. Default: `false`.
- Status (`status`, text): Only astronauts with this status. One of: `1` (Active), `3` (In training), `2` (Retired), `14` (Occasional spaceflight), `11` (Deceased), `4` (Lost in flight), `5` (Lost in training), `6` (Died while in active service), `7` (Dismissed), `8` (Resigned during training).
- Agency (`agency`, text): Only astronauts of this agency. Leave empty for all.
- Max results (`limit`, number): Return at most this many. Any number up to 100 uses one request. From 1 to 100. Default: `10`.
- Skip (`offset`, number): Skip this many results first, to get the next page. From 0 to 100000. Default: `0`.

**Outputs**

- `astronauts` (list): The astronauts.
- `count` (number): How many astronauts this step returned.
- `has_more` (true/false): Whether more match than were returned; use Skip for the next page.
- `total` (number): How many astronauts match in all.

**Example output**

```json
{
  "astronauts": [
    {
      "age": 50,
      "agency": "National Aeronautics and Space Administration",
      "agency_id": 44,
      "bio": "Anil Menon is a US Air Force lieutenant colonel from Minneapolis, Minnesota. He was SpaceX\u2019s first flight surgeon, helping to launch the company\u2019s first humans to space during NASA\u2019s SpaceX Demo-2 mission and building a\u2026",
      "date_of_birth": "1976-01-01",
      "date_of_death": null,
      "days_in_space": 92.4,
      "first_flight": "2026-07-14T14:47:43Z",
      "flights_count": 1,
      "id": 713,
      "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/anil_menon_image_20211206185413.jpg",
      "in_space": true,
      "last_flight": "2026-07-14T14:47:43Z",
      "name": "Anil Menon",
      "nationality": "United States of America",
      "nationality_code": "US",
      "spacewalk_hours": 19.5,
      "spacewalks_count": 3,
      "status": "Active",
      "wiki_url": "https://en.wikipedia.org/wiki/Anil_Menon_(astronaut)"
    }
  ],
  "count": 1,
  "has_more": false,
  "total": 11
}
```

### List dockings

Spacecraft dockings at space stations, most recent first.

**Inputs**

- Space station (`space_station`, text): Only this station. Leave empty for all. One of: `4` (International Space Station), `18` (Tiangong space station).
- Still docked only (`still_docked_only`, true/false): Only spacecraft that haven't left yet. Default: `false`.
- Docked from (`docked_after`, date and time): Only dockings at or after this time.
- Docked to (`docked_before`, date and time): Only dockings at or before this time.
- Max results (`limit`, number): Return at most this many. Any number up to 100 uses one request. From 1 to 100. Default: `10`.
- Skip (`offset`, number): Skip this many results first, to get the next page. From 0 to 100000. Default: `0`.

**Outputs**

- `count` (number): How many dockings this step returned.
- `dockings` (list): The dockings.
- `has_more` (true/false): Whether more match than were returned; use Skip for the next page.
- `total` (number): How many dockings match in all.

**Example output**

```json
{
  "count": 1,
  "dockings": [
    {
      "departed_at": null,
      "docked_at": "2026-10-15T14:27:00Z",
      "id": 645,
      "launch": "Falcon 9 Block 5 | Dragon CRS-2 SpX-35",
      "launch_id": "bf2c3027-a314-403e-a416-2bfd5d165ad1",
      "port": "Harmony zenith",
      "space_station": "International Space Station",
      "space_station_id": 4,
      "still_docked": true,
      "vehicle": "Cargo Dragon C211"
    }
  ],
  "has_more": true,
  "total": 329
}
```

### List expeditions

Crews' stays aboard space stations, newest first, each with its crew. Turn on Current only to see who lives aboard now.

**Inputs**

- Space station (`space_station`, text): Only this station. Leave empty for all. One of: `4` (International Space Station), `18` (Tiangong space station).
- Current only (`active_only`, true/false): Only expeditions going on now. Default: `false`.
- Search (`search`, text): Words to look for in the expedition's name.
- Max results (`limit`, number): Return at most this many. Any number up to 100 uses one request. From 1 to 100. Default: `10`.
- Skip (`offset`, number): Skip this many results first, to get the next page. From 0 to 100000. Default: `0`.

**Outputs**

- `count` (number): How many expeditions this step returned.
- `expeditions` (list): The expeditions.
- `has_more` (true/false): Whether more match than were returned; use Skip for the next page.
- `total` (number): How many expeditions match in all.

**Example output**

```json
{
  "count": 1,
  "expeditions": [
    {
      "active": true,
      "crew": [
        {
          "agency": "Russian Federal Space Agency (ROSCOSMOS)",
          "astronaut_id": 650,
          "name": "Pyotr Dubrov",
          "role": "Commander"
        },
        {
          "agency": "National Aeronautics and Space Administration",
          "astronaut_id": 713,
          "name": "Anil Menon",
          "role": "Flight Engineer"
        },
        {
          "agency": "Canadian Space Agency",
          "astronaut_id": 642,
          "name": "Joshua Kutryk",
          "role": "Flight Engineer"
        }
      ],
      "end": null,
      "id": 168,
      "name": "Expedition 75",
      "space_station": "International Space Station",
      "space_station_id": 4,
      "spacewalks": [
        "Expedition 75 EVA 4",
        "Expedition 75 EVA 3",
        "Expedition 75 EVA 2"
      ],
      "start": "2026-07-26T07:02:00Z"
    }
  ],
  "has_more": false,
  "total": 2
}
```

### List launch sites

Spaceports and launch sites, busiest first, with their location and launch counts.

**Inputs**

- Search (`search`, text): Words to look for in the site's name.
- Country (`country`, text): Only those in this country. Leave empty for all. One of: `USA` (United States), `CHN` (China), `RUS` (Russia), `FRA` (France), `GUF` (French Guiana), `JPN` (Japan), `IND` (India), `GBR` (United Kingdom), `DEU` (Germany), `ITA` (Italy), and 20 more.
- In use only (`active_only`, true/false): Only sites still in use. Default: `false`.
- Max results (`limit`, number): Return at most this many. Any number up to 100 uses one request. From 1 to 100. Default: `10`.
- Skip (`offset`, number): Skip this many results first, to get the next page. From 0 to 100000. Default: `0`.

**Outputs**

- `count` (number): How many launch sites this step returned.
- `has_more` (true/false): Whether more match than were returned; use Skip for the next page.
- `launch_sites` (list): The launch sites.
- `total` (number): How many launch sites match in all.

**Example output**

```json
{
  "count": 1,
  "has_more": true,
  "launch_sites": [
    {
      "active": true,
      "country": "United States of America",
      "country_code": "US",
      "description": "Cape Canaveral Space Force Station (CCSFS) is an installation of the United States Space Force's Space Launch Delta 45, located on Cape Canaveral in Brevard County, Florida.",
      "id": 12,
      "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/cape_canaveral__image_20240918151615.jpg",
      "latitude": 28.488889,
      "longitude": -80.577778,
      "map_image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_12_20200803142519.jpg",
      "name": "Cape Canaveral SFS, FL, USA",
      "timezone": "America/New_York",
      "total_landing_count": 83,
      "total_launch_count": 1131
    }
  ],
  "total": 11
}
```

### List previous launches

Rocket launches that have happened, most recent first, with how they went.

**Inputs**

- Launch provider (`launch_provider`, text): Only launches by this company or agency, such as SpaceX or Rocket Lab. Leave empty for all.
- Launch site (`launch_site`, text): Only launches from this site, such as Cape Canaveral or Baikonur. Leave empty for all.
- Crewed only (`crewed_only`, true/false): Only launches with people on board. Default: `false`.
- Max results (`limit`, number): Return at most this many. Any number up to 100 uses one request. From 1 to 100. Default: `10`.
- Skip (`offset`, number): Skip this many results first, to get the next page. From 0 to 100000. Default: `0`.

**Outputs**

- `count` (number): How many launches this step returned.
- `has_more` (true/false): Whether more match than were returned; use Skip for the next page.
- `launches` (list): The launches.
- `total` (number): How many launches match in all.

**Example output**

```json
{
  "count": 1,
  "has_more": true,
  "launches": [
    {
      "country": "United States of America",
      "country_code": "US",
      "failure_reason": null,
      "id": "bf2c3027-a314-403e-a416-2bfd5d165ad1",
      "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/falcon2520925_image_20210520085648.jpeg",
      "last_updated": "2026-10-15T14:52:24Z",
      "launch_provider": "SpaceX",
      "launch_provider_id": 121,
      "launch_site": "Cape Canaveral SFS, FL, USA",
      "launch_site_id": 12,
      "launch_time": "2026-10-13T10:33:44Z",
      "mission": "Dragon CRS-2 SpX-35",
      "mission_description": "35th commercial resupply services mission to the International Space Station operated by SpaceX. The flight will be conducted under the second Commercial Resupply Services contract with NASA.\r\n\r\nCargo Dragon 2 brings\u2026",
      "mission_type": "Resupply",
      "name": "Falcon 9 Block 5 | Dragon CRS-2 SpX-35",
      "orbit": "Low Earth Orbit",
      "pad": "Space Launch Complex 40",
      "probability": 99,
      "rocket": "Falcon 9 Block 5",
      "rocket_id": 164,
      "status": "Launch Successful",
      "status_abbreviation": "Success",
      "time_precision": "Second",
      "webcast_live": false,
      "window_end": "2026-10-13T10:33:44Z",
      "window_start": "2026-10-13T10:33:44Z"
    }
  ],
  "total": 738
}
```

### List programs

Spaceflight programs, such as Artemis or Starship, newest first.

**Inputs**

- Search (`search`, text): Words to look for in the program's name or description.
- Max results (`limit`, number): Return at most this many. Any number up to 100 uses one request. From 1 to 100. Default: `10`.
- Skip (`offset`, number): Skip this many results first, to get the next page. From 0 to 100000. Default: `0`.

**Outputs**

- `count` (number): How many programs this step returned.
- `has_more` (true/false): Whether more match than were returned; use Skip for the next page.
- `programs` (list): The programs.
- `total` (number): How many programs match in all.

**Example output**

```json
{
  "count": 1,
  "has_more": false,
  "programs": [
    {
      "agencies": [
        "National Aeronautics and Space Administration"
      ],
      "description": "The Artemis program is a US government-funded crewed spaceflight program that has the goal of landing \"the first woman and the next man\" on the Moon, specifically at the lunar south pole region.",
      "end_date": null,
      "id": 15,
      "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/artemis_program_20220827100930.png",
      "info_url": "https://www.nasa.gov/specials/artemis/",
      "name": "Artemis",
      "start_date": "2017-12-11T00:00:00Z",
      "type": "Human Spaceflight",
      "wiki_url": "https://en.wikipedia.org/wiki/Artemis_program"
    }
  ],
  "total": 1
}
```

### List rockets

Rocket models with their size, payload capacity, cost and launch record, most launched first.

**Inputs**

- Search (`search`, text): Words to look for in the rocket's name, such as Falcon or Long March.
- Manufacturer (`manufacturer`, text): Only rockets built by a maker whose name contains this.
- In service only (`active_only`, true/false): Only rockets that still fly. Default: `false`.
- Max results (`limit`, number): Return at most this many. Any number up to 100 uses one request. From 1 to 100. Default: `10`.
- Skip (`offset`, number): Skip this many results first, to get the next page. From 0 to 100000. Default: `0`.

**Outputs**

- `count` (number): How many rockets this step returned.
- `has_more` (true/false): Whether more match than were returned; use Skip for the next page.
- `rockets` (list): The rockets.
- `total` (number): How many rockets match in all.

**Example output**

```json
{
  "count": 1,
  "has_more": false,
  "rockets": [
    {
      "active": true,
      "description": "Falcon 9 is a two-stage rocket designed and manufactured by SpaceX for the reliable and safe transport of satellites and the Dragon spacecraft into orbit. The Block 5 variant is the fifth major interval aimed at\u2026",
      "diameter_m": 3.65,
      "failed_launches": 1,
      "family": "Falcon",
      "gto_capacity_kg": 8300.0,
      "id": 164,
      "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/falcon_9_image_20230807133459.jpeg",
      "info_url": "https://www.spacex.com/vehicles/falcon-9/",
      "launch_cost_usd": 52000000,
      "launch_mass_tonnes": 549.0,
      "length_m": 70.0,
      "leo_capacity_kg": 22800.0,
      "maiden_flight": "2018-05-11",
      "manufacturer": "SpaceX",
      "manufacturer_id": 121,
      "name": "Falcon 9 Block 5",
      "pending_launches": 119,
      "reusable": true,
      "successful_landings": 624,
      "successful_launches": 638,
      "total_launch_count": 639,
      "variant": "Block 5",
      "wiki_url": "https://en.wikipedia.org/wiki/Falcon_9"
    }
  ],
  "total": 2
}
```

### List space stations

Space stations past and present, newest first.

**Inputs**

- Status (`status`, text): Only stations with this status. Leave empty for all. One of: `1` (Active), `2` (De-orbited), `3` (Decommissioned).
- Search (`search`, text): Words to look for in the station's name.
- Max results (`limit`, number): Return at most this many. Any number up to 100 uses one request. From 1 to 100. Default: `10`.
- Skip (`offset`, number): Skip this many results first, to get the next page. From 0 to 100000. Default: `0`.

**Outputs**

- `count` (number): How many space stations this step returned.
- `has_more` (true/false): Whether more match than were returned; use Skip for the next page.
- `space_stations` (list): The space stations.
- `total` (number): How many space stations match in all.

**Example output**

```json
{
  "count": 1,
  "has_more": false,
  "space_stations": [
    {
      "deorbited": null,
      "description": "The Tiangong space station is a space station placed in Low Earth orbit between 340 and 450 km above the surface. It will be roughly one-fifth the mass of the International Space Station and about the size of the Mir\u2026",
      "founded": "2021-04-29",
      "id": 18,
      "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/tiangong_space__image_20231031004146.png",
      "name": "Tiangong space station",
      "orbit": "Low Earth Orbit",
      "owners": [
        "China Aerospace Science and Technology Corporation"
      ],
      "status": "Active",
      "type": "Government"
    }
  ],
  "total": 2
}
```

### List spacecraft

Individual spacecraft, such as the Crew Dragon Endeavour or a Soyuz, with their flights and time in space.

**Inputs**

- Search (`search`, text): Words to look for in the spacecraft's name.
- In space now (`in_space_only`, true/false): Only spacecraft in space right now. Default: `false`.
- Status (`status`, text): Only spacecraft with this status. One of: `1` (Active), `2` (Retired), `3` (Destroyed), `4` (Single use), `5` (Under construction).
- Max results (`limit`, number): Return at most this many. Any number up to 100 uses one request. From 1 to 100. Default: `10`.
- Skip (`offset`, number): Skip this many results first, to get the next page. From 0 to 100000. Default: `0`.

**Outputs**

- `count` (number): How many spacecraft this step returned.
- `has_more` (true/false): Whether more match than were returned; use Skip for the next page.
- `spacecraft` (list): The spacecraft.
- `total` (number): How many spacecraft match in all.

**Example output**

```json
{
  "count": 1,
  "has_more": true,
  "spacecraft": [
    {
      "days_docked": 25.5,
      "days_in_space": 28.5,
      "description": "Progress MS-35 is a Progress spacecraft used by Roscosmos to resupply the International Space Station (ISS).",
      "flights_count": 1,
      "id": 633,
      "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/progress-ms_image_20231219150735.jpeg",
      "in_space": true,
      "name": "Progress MS-35",
      "operator": "Russian Federal Space Agency (ROSCOSMOS)",
      "serial_number": "MS-35 (No.465)",
      "spacecraft_type": "Progress-MS",
      "status": "Active"
    }
  ],
  "total": 10
}
```

### List upcoming events

Spaceflight events coming up, soonest first: dockings, spacewalks, landings, tests, press events and more.

**Inputs**

- Event type (`event_type`, text): Only events of this kind. Leave empty for all. One of: `2` (Docking), `8` (Undocking), `3` (Spacewalk (EVA)), `24` (Launch), `9` (Spacecraft landing), `7` (Moon landing), `5` (Static fire), `22` (Wet dress rehearsal), `27` (Rollout), `14` (Test flight), and 17 more.
- Search (`search`, text): Words to look for in the event's name.
- Max results (`limit`, number): Return at most this many. Any number up to 100 uses one request. From 1 to 100. Default: `10`.
- Skip (`offset`, number): Skip this many results first, to get the next page. From 0 to 100000. Default: `0`.

**Outputs**

- `count` (number): How many events this step returned.
- `events` (list): The events.
- `has_more` (true/false): Whether more match than were returned; use Skip for the next page.
- `total` (number): How many events match in all.

**Example output**

```json
{
  "count": 1,
  "events": [
    {
      "date": "2026-10-15T19:30:00Z",
      "date_precision": "Minute",
      "description": "After more than seven months aboard the International Space Station, NASA\u2019s SpaceX Crew-12 mission safely splashed down in the Pacific Ocean off the coast of Los Angeles. The crew members will discuss their science\u2026",
      "id": 1563,
      "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/crew-12_spacex__image_20260126082450.png",
      "info_url": "https://www.nasa.gov/news-release/nasas-spacex-crew-12-splashes-down-sets-briefing-to-discuss-mission/",
      "last_updated": "2026-10-09T06:39:23Z",
      "location": "Johnson Space Center, Houston, TX, USA",
      "name": "SpaceX Crew-12 Post-Flight News Conference",
      "type": "Press Event",
      "video_url": null,
      "webcast_live": false
    }
  ],
  "has_more": true,
  "total": 32
}
```

### List upcoming launches

Rocket launches that haven't happened yet, soonest first, with time, rocket, mission, pad and status.

**Inputs**

- Launch provider (`launch_provider`, text): Only launches by this company or agency, such as SpaceX or Rocket Lab. Leave empty for all.
- Launch site (`launch_site`, text): Only launches from this site, such as Cape Canaveral or Baikonur. Leave empty for all.
- Crewed only (`crewed_only`, true/false): Only launches with people on board. Default: `false`.
- Max results (`limit`, number): Return at most this many. Any number up to 100 uses one request. From 1 to 100. Default: `10`.
- Skip (`offset`, number): Skip this many results first, to get the next page. From 0 to 100000. Default: `0`.

**Outputs**

- `count` (number): How many launches this step returned.
- `has_more` (true/false): Whether more match than were returned; use Skip for the next page.
- `launches` (list): The launches.
- `total` (number): How many launches match in all.

**Example output**

```json
{
  "count": 1,
  "has_more": true,
  "launches": [
    {
      "country": "United States of America",
      "country_code": "US",
      "failure_reason": null,
      "id": "df88cfbf-f504-4e11-8370-e33dd6280b5b",
      "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/falcon_9_liftof_image_20260816171423.jpg",
      "last_updated": "2026-10-15T15:36:15Z",
      "launch_provider": "SpaceX",
      "launch_provider_id": 121,
      "launch_site": "Vandenberg SFB, CA, USA",
      "launch_site_id": 11,
      "launch_time": "2026-10-15T23:57:05Z",
      "mission": "USSF-481",
      "mission_description": "A classified mission for the United States Space Force. It is possibly a batch of classified LEO satellites based on SpaceX\u2019s Starshield satellite bus, based on locations of ascent rocket stage drop zones being fits\u2026",
      "mission_type": "Government/Top Secret",
      "name": "Falcon 9 Block 5 | USSF-481",
      "orbit": "Polar Orbit",
      "pad": "Space Launch Complex 4E",
      "probability": null,
      "rocket": "Falcon 9 Block 5",
      "rocket_id": 164,
      "status": "Go for Launch",
      "status_abbreviation": "Go",
      "time_precision": "Second",
      "webcast_live": false,
      "window_end": "2026-10-16T03:44:00Z",
      "window_start": "2026-10-15T23:44:00Z"
    }
  ],
  "total": 473
}
```

### List updates

The Launch Library editors' latest notes on launches, such as a new date or GO for launch, newest first.

**Inputs**

- Launch ID (`launch_id`, text): Only notes about this launch, from a launch list step. Leave empty for all.
- Max results (`limit`, number): Return at most this many. Any number up to 100 uses one request. From 1 to 100. Default: `10`.
- Skip (`offset`, number): Skip this many results first, to get the next page. From 0 to 100000. Default: `0`.

**Outputs**

- `count` (number): How many updates this step returned.
- `has_more` (true/false): Whether more match than were returned; use Skip for the next page.
- `total` (number): How many updates match in all.
- `updates` (list): The updates.

**Example output**

```json
{
  "count": 1,
  "has_more": true,
  "total": 15174,
  "updates": [
    {
      "comment": "Added tentative launch window.",
      "created_by": "Cosmic_Penguin",
      "created_on": "2026-10-15T17:54:00Z",
      "id": 16497,
      "info_url": "https://forum.nasaspaceflight.com/index.php?topic=66207.msg2832951#msg2832951"
    }
  ]
}
```

### Search launches

Find launches, past or future, by words, dates, launch provider, launch site and status.

**Inputs**

- Search (`search`, text): Words to look for in the launch or mission name, such as Starlink or Artemis.
- From (`launched_after`, date and time): Only launches at or after this time.
- To (`launched_before`, date and time): Only launches at or before this time.
- Launch provider (`launch_provider`, text): Only launches by this company or agency, such as SpaceX or Rocket Lab. Leave empty for all.
- Launch site (`launch_site`, text): Only launches from this site, such as Cape Canaveral or Baikonur. Leave empty for all.
- Status (`statuses`, list): Only launches with one of these statuses. One or more of: `1` (Go for launch), `8` (To be confirmed), `2` (To be determined), `5` (On hold), `6` (In flight), `3` (Successful), `7` (Partial failure), `4` (Failure), `9` (Payload deployed).
- Crewed only (`crewed_only`, true/false): Only launches with people on board. Default: `false`.
- Order (`sort`, text): Which launches come first. One of: `oldest` (Oldest first), `newest` (Newest first). Default: `oldest`.
- Max results (`limit`, number): Return at most this many. Any number up to 100 uses one request. From 1 to 100. Default: `10`.
- Skip (`offset`, number): Skip this many results first, to get the next page. From 0 to 100000. Default: `0`.

**Outputs**

- `count` (number): How many launches this step returned.
- `has_more` (true/false): Whether more match than were returned; use Skip for the next page.
- `launches` (list): The launches.
- `total` (number): How many launches match in all.

**Example output**

```json
{
  "count": 1,
  "has_more": true,
  "launches": [
    {
      "country": "United States of America",
      "country_code": "US",
      "failure_reason": null,
      "id": "10fbecb2-7624-44bc-85ce-9a22b9b9f2ec",
      "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/falcon2520925_image_20221009234147.png",
      "last_updated": "2026-03-31T02:49:40Z",
      "launch_provider": "SpaceX",
      "launch_provider_id": 121,
      "launch_site": "Cape Canaveral SFS, FL, USA",
      "launch_site_id": 12,
      "launch_time": "2026-03-30T21:15:00Z",
      "mission": "Starlink Group 10-44",
      "mission_description": "A batch of 29 satellites for the Starlink mega-constellation - SpaceX's project for space-based Internet communication system.",
      "mission_type": "Communications",
      "name": "Falcon 9 Block 5 | Starlink Group 10-44",
      "orbit": "Low Earth Orbit",
      "pad": "Space Launch Complex 40",
      "probability": 70,
      "rocket": "Falcon 9 Block 5",
      "rocket_id": 164,
      "status": "Launch Successful",
      "status_abbreviation": "Success",
      "time_precision": "Second",
      "webcast_live": false,
      "window_end": "2026-03-31T01:15:00Z",
      "window_start": "2026-03-30T21:15:00Z"
    }
  ],
  "total": 18
}
```