Launch Instance
AN API endpoint that returns all Launch objects or a single launch.
EXAMPLE - /launch/[id]/ or /launch/?mode=list&search=SpaceX
GET Return a list of all Launch objects.
FILTERS Fields - 'name', 'id(s)', 'lsp__id', 'lsp__name', 'serial_number', 'launcher_config__id', 'rocket__spacecraftflight__spacecraft__name', 'is_crewed', 'include_suborbital', 'spacecraft_config__ids', 'related', 'location__ids', 'lsp__ids', 'pad__ids', 'status__ids'
MODE 'normal', 'list', 'detailed'
EXAMPLE ?mode=list
SEARCH Searches through the launch name, rocket name, launch agency, mission name & spacecraft name.
EXAMPLE - ?search=SpaceX
GET /2.2.0/launch/07e945c1-2ec6-4d29-a500-1afbe920440f/?format=api
{ "id": "07e945c1-2ec6-4d29-a500-1afbe920440f", "url": "https://lldev.thespacedevs.com/2.2.0/launch/07e945c1-2ec6-4d29-a500-1afbe920440f/?format=api", "slug": "atlas-v-n22-starliner-1", "flightclub_url": null, "r_spacex_api_id": null, "name": "Atlas V N22 | Starliner-1", "status": { "id": 2, "name": "To Be Determined", "abbrev": "TBD", "description": "Current date is a placeholder or rough estimation based on unreliable or interpreted sources." }, "last_updated": "2025-11-24T18:14:22Z", "updates": [ { "id": 13027, "profile_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET April 2026.", "info_url": "https://x.com/NASASpaceflight/status/1993015720372797553", "created_by": "Cosmic_Penguin", "created_on": "2025-11-24T18:14:00Z" }, { "id": 8907, "profile_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET 2025 pending certification plan update.", "info_url": "https://blogs.nasa.gov/commercialcrew/2024/10/15/nasa-updates-2025-commercial-crew-plan/", "created_by": "Cosmic_Penguin", "created_on": "2024-10-15T18:25:00Z" }, { "id": 11213, "profile_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET Q1 2026.", "info_url": "https://x.com/NASASpaceflight/status/1931090899506753718", "created_by": "Cosmic_Penguin", "created_on": "2025-06-07T02:12:00Z" }, { "id": 3805, "profile_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET summer 2024", "info_url": "https://blogs.nasa.gov/commercialcrew/2023/04/14/nasa-updates-commercial-crew-planning-manifest-through-2024/", "created_by": "Cosmic_Penguin", "created_on": "2023-04-15T00:04:39Z" }, { "id": 3838, "profile_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "NET August 2024", "info_url": "https://twitter.com/SciGuySpace/status/1648507444556107779", "created_by": "Nosu", "created_on": "2023-04-19T06:17:40Z" }, { "id": 5400, "profile_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET early 2025, pending assignment.", "info_url": "https://blogs.nasa.gov/commercialcrew/2023/10/12/nasa-updates-commercial-crew-planning-manifest/", "created_by": "Cosmic_Penguin", "created_on": "2023-10-12T16:11:01Z" }, { "id": 8133, "profile_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/profile_images/lucas2520stauder_profile_20230526163835.jpg", "comment": "NET August 2025", "info_url": "https://x.com/jeff_foust/status/1816868217307959550", "created_by": "hitura-nobad", "created_on": "2024-07-26T16:11:47Z" } ], "net": "2026-04-30T00:00:00Z", "net_precision": { "id": 7, "name": "Month", "abbrev": "M", "description": "The T-0 is expected in the given month." }, "window_end": "2026-04-30T00:00:00Z", "window_start": "2026-04-30T00:00:00Z", "probability": null, "weather_concerns": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 124, "url": "https://lldev.thespacedevs.com/2.2.0/agencies/124/?format=api", "name": "United Launch Alliance", "featured": true, "type": "Commercial", "country_code": "USA", "abbrev": "ULA", "description": "United Launch Alliance (ULA) is a joint venture of Lockheed Martin Space Systems and Boeing Defense, Space & Security. ULA was formed in December 2006 by combining the teams at these companies which provide spacecraft launch services to the government of the United States. ULA launches from both coasts of the US. They launch their Atlas V vehicle from LC-41 in Cape Canaveral and LC-3E at Vandeberg. Their Delta IV launches from LC-37 at Cape Canaveral and LC-6 at Vandenberg.", "administrator": "CEO: Tory Bruno", "founding_year": "2006", "launchers": "Atlas | Delta IV | Vulcan", "spacecraft": "CST-100 Starliner", "launch_library_url": null, "total_launch_count": 169, "consecutive_successful_launches": 169, "successful_launches": 169, "failed_launches": 0, "pending_launches": 42, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://www.ulalaunch.com/", "wiki_url": "https://en.wikipedia.org/wiki/United_Launch_Alliance", "logo_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/united2520launch2520alliance_logo_20210412195953.png", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/united_launch_a_image_20210412201210.png", "nation_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/united2520launch2520alliance_nation_20230531043703.jpg" }, "rocket": { "id": 2710, "configuration": { "id": 166, "url": "https://lldev.thespacedevs.com/2.2.0/config/launcher/166/?format=api", "name": "Atlas V N22", "active": true, "reusable": false, "description": "The Atlas V N22 is a crew rated variant of the Atlas V 422 - it sports two solid motor strap on boosters with two liquid fueled stages. It will be primarly used to support NASA's Commercial Crew program by taking the CST-100 to orbit.", "family": "Atlas", "full_name": "Atlas V N22", "manufacturer": { "id": 124, "url": "https://lldev.thespacedevs.com/2.2.0/agencies/124/?format=api", "name": "United Launch Alliance", "featured": true, "type": "Commercial", "country_code": "USA", "abbrev": "ULA", "description": "United Launch Alliance (ULA) is a joint venture of Lockheed Martin Space Systems and Boeing Defense, Space & Security. ULA was formed in December 2006 by combining the teams at these companies which provide spacecraft launch services to the government of the United States. ULA launches from both coasts of the US. They launch their Atlas V vehicle from LC-41 in Cape Canaveral and LC-3E at Vandeberg. Their Delta IV launches from LC-37 at Cape Canaveral and LC-6 at Vandenberg.", "administrator": "CEO: Tory Bruno", "founding_year": "2006", "launchers": "Atlas | Delta IV | Vulcan", "spacecraft": "CST-100 Starliner", "launch_library_url": null, "total_launch_count": 169, "consecutive_successful_launches": 169, "successful_launches": 169, "failed_launches": 0, "pending_launches": 42, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://www.ulalaunch.com/", "wiki_url": "https://en.wikipedia.org/wiki/United_Launch_Alliance", "logo_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/united2520launch2520alliance_logo_20210412195953.png", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/united_launch_a_image_20210412201210.png", "nation_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/united2520launch2520alliance_nation_20230531043703.jpg" }, "program": [], "variant": "V N22", "alias": "", "min_stage": 2, "max_stage": 2, "length": 58.0, "diameter": 3.8, "maiden_flight": "2019-12-20", "launch_cost": "110000000", "launch_mass": null, "leo_capacity": 13034, "gto_capacity": null, "to_thrust": null, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/atlas_v_n22_image_20210813082339.jpeg", "info_url": "https://www.ulalaunch.com/rockets/atlas-v", "wiki_url": "https://en.wikipedia.org/wiki/Atlas_V", "total_launch_count": 3, "consecutive_successful_launches": 3, "successful_launches": 3, "failed_launches": 0, "pending_launches": 6, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": { "id": 574, "url": "https://lldev.thespacedevs.com/2.2.0/spacecraft/flight/574/?format=api", "mission_end": null, "destination": "International Space Station", "launch_crew": [], "onboard_crew": [], "landing_crew": [], "spacecraft": { "id": 290, "url": "https://lldev.thespacedevs.com/2.2.0/spacecraft/290/?format=api", "name": "Starliner 2", "serial_number": "2", "is_placeholder": false, "in_space": false, "time_in_space": "P5DT23H54M13S", "time_docked": "P4DT18H8M", "flights_count": 1, "mission_ends_count": 1, "status": { "id": 1, "name": "Active" }, "description": "The second CST-100 Starliner capsule to fly.", "spacecraft_config": { "id": 9, "url": "https://lldev.thespacedevs.com/2.2.0/config/spacecraft/9/?format=api", "name": "CST-100 Starliner", "type": { "id": 2, "name": "Capsule" }, "agency": { "id": 80, "url": "https://lldev.thespacedevs.com/2.2.0/agencies/80/?format=api", "name": "Boeing", "featured": false, "type": "Commercial", "country_code": "USA", "abbrev": "BA", "description": "Boeing as a space agency has recently provided NASA with assistance on sending humans to the ISS from American with both their construction of the CST-100 Starliner crew capsule and their work on the SLS Avionics to return to the moon and beyond. Their ventures in GPS satellite systems and Tracking and Data Relay Satellites provide information about earth-orbiting craft to stations on the ground. They also enable research on the ISS and will be helping with the construction of the Lunar Gateway.", "administrator": "CEO: Kelly Ortberg", "founding_year": "1916", "launchers": "SLS", "spacecraft": "Starliner", "parent": null, "image_url": null, "logo_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/boeing_logo_20201128183345.png" }, "in_use": true, "capability": "Cargo and Human Transportation", "history": "The design draws upon Boeing's experience with NASA's Apollo, Space Shuttle and ISS programs as well as the Orbital Express project sponsored by the Department of Defense. A variety of validation tests have been underway on test articles since 2011.\r\n\r\nThe uncrewed orbital flight test launched on December 20, 2019, but after deployment, an 11-hour offset in the mission clock of Starliner caused the spacecraft to do a large engine burn, consumeing to much fuel, to reach the International Space Station, leading to an early return.\r\n\r\nA second uncrewed orbital flight test launched on May 19, 2022, which successfully reached the International Space Station.", "details": "The Boeing CST-100 Starliner (Crew Space Transportation) crew capsule is a spacecraft design under construction by Boeing as their entry for NASA's Commercial Crew Development program. Its primary purpose is to transport crew to the International Space Station and to private space stations. It is launched on United Launch Alliance Atlas V Rocket.", "maiden_flight": "2019-08-17", "height": 5.03, "diameter": 4.56, "human_rated": true, "crew_capacity": 7, "payload_capacity": null, "payload_return_capacity": null, "flight_life": "210 days docked, 60 hours free flight.", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/boeing_starline_image_20220525180700.jpeg", "nation_url": null, "wiki_link": "https://en.wikipedia.org/wiki/Boeing_CST-100_Starliner", "info_link": "http://www.boeing.com/space/starliner/" } }, "landing": { "id": 1049, "attempt": true, "success": null, "description": "The Starliner spacecraft will land at White Sands Missile Range.", "downrange_distance": null, "location": { "id": 20, "name": "White Sands Missile Range", "abbrev": "WSMR", "description": "US Army testing area and firing range located in the US state of New Mexico.", "location": { "id": 155, "url": "https://lldev.thespacedevs.com/2.2.0/location/155/?format=api", "name": "White Sands Missile Range", "country_code": "USA", "description": "White Sands Missile Range is a United States Army military testing area and firing range located in the US state of New Mexico. The range was originally established in 1941 as the Alamogordo Bombing and Gunnery Range, where the Trinity test site lay at the northern end of the Range, in Socorro County near the towns of Carrizozo and San Antonio. It then became the White Sands Proving Ground on 9 July 1945.", "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/location_white_sands_missile_range_20210901072636.jpg", "timezone_name": "America/Denver", "total_launch_count": 5, "total_landing_count": 0 }, "successful_landings": 5 }, "type": { "id": 4, "name": "Parachute Landing", "abbrev": "PCL", "description": "Unpowered landing using parachute(s)." } }, "docking_events": [] } }, "mission": { "id": 1113, "name": "Starliner-1", "description": "Starliner-1 is the first operational flight of a Starliner spacecraft to the International Space Station as part of NASA's Commercial Crew Program. Due to problems with the Starliner spacecraft's RCS attitude control system during the Crew Flight Test mission in 2024, this mission has been re-scoped to not carry a crew by NASA. It will instead deliver necessary cargo to the orbital laboratory and allow in-flight validation of the system upgrades implemented following the Crew Flight Test mission last year.", "launch_designator": null, "type": "Human Exploration", "orbit": { "id": 8, "name": "Low Earth Orbit", "abbrev": "LEO" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 29, "url": "https://lldev.thespacedevs.com/2.2.0/pad/29/?format=api", "agency_id": null, "name": "Space Launch Complex 41", "description": "", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Cape_Canaveral_Air_Force_Station_Space_Launch_Complex_41", "map_url": "https://www.google.com/maps?q=28.58341025,-80.58303644", "latitude": "28.58341025", "longitude": "-80.58303644", "location": { "id": 12, "url": "https://lldev.thespacedevs.com/2.2.0/location/12/?format=api", "name": "Cape Canaveral SFS, FL, USA", "country_code": "USA", "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.", "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/location_12_20200803142519.jpg", "timezone_name": "America/New_York", "total_launch_count": 1074, "total_landing_count": 70 }, "country_code": "USA", "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/pad_29_20200803143528.jpg", "total_launch_count": 119, "orbital_launch_attempt_count": 119 }, "infoURLs": [], "vidURLs": [], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/atlas_v_n22_image_20210813082339.jpeg", "infographic": null, "program": [ { "id": 17, "url": "https://lldev.thespacedevs.com/2.2.0/program/17/?format=api", "name": "International Space Station", "description": "The International Space Station programme is tied together by a complex set of legal, political and financial agreements between the sixteen nations involved in the project, governing ownership of the various components, rights to crewing and utilization, and responsibilities for crew rotation and resupply of the International Space Station. It was conceived in 1984 by President Ronald Reagan, during the Space Station Freedom project as it was originally called.", "agencies": [ { "id": 16, "url": "https://lldev.thespacedevs.com/2.2.0/agencies/16/?format=api", "name": "Canadian Space Agency", "type": "Government" }, { "id": 27, "url": "https://lldev.thespacedevs.com/2.2.0/agencies/27/?format=api", "name": "European Space Agency", "type": "Multinational" }, { "id": 37, "url": "https://lldev.thespacedevs.com/2.2.0/agencies/37/?format=api", "name": "Japan Aerospace Exploration Agency", "type": "Government" }, { "id": 44, "url": "https://lldev.thespacedevs.com/2.2.0/agencies/44/?format=api", "name": "National Aeronautics and Space Administration", "type": "Government" }, { "id": 63, "url": "https://lldev.thespacedevs.com/2.2.0/agencies/63/?format=api", "name": "Russian Federal Space Agency (ROSCOSMOS)", "type": "Government" } ], "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/international2_program_20201129184745.png", "start_date": "1998-11-20T06:40:00Z", "end_date": null, "info_url": "https://www.nasa.gov/mission_pages/station/main/index.html", "wiki_url": "https://en.wikipedia.org/wiki/International_Space_Station_programme", "mission_patches": [], "type": { "id": 2, "name": "Human Spaceflight" } }, { "id": 5, "url": "https://lldev.thespacedevs.com/2.2.0/program/5/?format=api", "name": "Commercial Crew Program", "description": "The Commercial Crew Program (CCP) is a human spaceflight program operated by NASA, in association with American aerospace manufacturers Boeing and SpaceX. The program conducts rotations between the expeditions of the International Space Station program, transporting crews to and from the International Space Station (ISS) aboard Boeing Starliner and SpaceX Crew Dragon capsules, in the first crewed orbital spaceflights operated by private companies.", "agencies": [ { "id": 80, "url": "https://lldev.thespacedevs.com/2.2.0/agencies/80/?format=api", "name": "Boeing", "type": "Commercial" }, { "id": 44, "url": "https://lldev.thespacedevs.com/2.2.0/agencies/44/?format=api", "name": "National Aeronautics and Space Administration", "type": "Government" }, { "id": 121, "url": "https://lldev.thespacedevs.com/2.2.0/agencies/121/?format=api", "name": "SpaceX", "type": "Commercial" } ], "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/commercial2520_program_20200820201209.png", "start_date": "2011-04-18T00:00:00Z", "end_date": null, "info_url": "https://www.nasa.gov/exploration/commercial/crew/index.html", "wiki_url": "https://en.wikipedia.org/wiki/Commercial_Crew_Program", "mission_patches": [], "type": { "id": 2, "name": "Human Spaceflight" } } ], "orbital_launch_attempt_count": 7228, "location_launch_attempt_count": 1090, "pad_launch_attempt_count": 126, "agency_launch_attempt_count": 176, "orbital_launch_attempt_count_year": 41, "location_launch_attempt_count_year": 10, "pad_launch_attempt_count_year": 6, "agency_launch_attempt_count_year": 6, "pad_turnaround": "P30D", "mission_patches": [], "type": "detailed" }
