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/a67b40f9-cfcc-4614-a355-a156280b4bb3/?format=api
{ "id": "a67b40f9-cfcc-4614-a355-a156280b4bb3", "url": "https://ll.thespacedevs.com/2.2.0/launch/a67b40f9-cfcc-4614-a355-a156280b4bb3/?format=api", "slug": "vulcan-vc4l-dream-chaser-crs-2-flight-1", "flightclub_url": null, "r_spacex_api_id": null, "name": "Vulcan VC4L | Dream Chaser CRS 2 Flight 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-03-10T16:25:58Z", "updates": [ { "id": 10372, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET late summer.", "info_url": "https://x.com/jeff_foust/status/1899124444225843231", "created_by": "Cosmic_Penguin", "created_on": "2025-03-10T16:25:00Z" }, { "id": 8807, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET May 2025.", "info_url": "https://x.com/SciGuySpace/status/1844087210859167976", "created_by": "Cosmic_Penguin", "created_on": "2024-10-10T02:19:00Z" }, { "id": 8752, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET 2025.", "info_url": "https://x.com/dpoddolphinpro/status/1841558631344709658", "created_by": "Cosmic_Penguin", "created_on": "2024-10-03T01:26:00Z" }, { "id": 7954, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Delayed due to payload testing issues, will no longer fly on the 2nd launch of Vulcan.", "info_url": "https://x.com/ulalaunch/status/1805994649967857981", "created_by": "Cosmic_Penguin", "created_on": "2024-06-26T16:10:53Z" }, { "id": 7527, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET early September.", "info_url": "https://spacenews.com/pentagon-urges-ula-to-fly-dummy-payload-on-next-vulcan-launch-if-dream-chaser-is-delayed/", "created_by": "Cosmic_Penguin", "created_on": "2024-05-14T10:00:32Z" }, { "id": 6622, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET summer 2024.", "info_url": "https://forum.nasaspaceflight.com/index.php?topic=56364.msg2565096#msg2565096", "created_by": "Cosmic_Penguin", "created_on": "2024-02-09T10:43:53Z" }, { "id": 5513, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET April 2024.", "info_url": "https://aviationweek.com/aerospace/commercial-space/ula-sets-dec-24-target-date-vulcans-debut", "created_by": "Cosmic_Penguin", "created_on": "2023-10-27T08:12:06Z" }, { "id": 4312, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET Early 2024.", "info_url": "https://spaceflightnow.com/launch-schedule/", "created_by": "Cosmic_Penguin", "created_on": "2023-06-09T02:41:24Z" }, { "id": 3655, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET December 2023", "info_url": "https://arstechnica.com/science/2023/03/dream-chaser-is-delayed-again-raising-questions-about-vulcan-launch-plans/", "created_by": "Cosmic_Penguin", "created_on": "2023-03-24T15:31:08Z" }, { "id": 3348, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "NET August", "info_url": "https://spaceflightnow.com/launch-schedule/", "created_by": "Nosu", "created_on": "2023-02-17T13:15:58Z" }, { "id": 2441, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/swgustav_profile_20210218062738.jpg", "comment": "NET Summer 2023", "info_url": "https://twitter.com/jeff_foust/status/1571868469188235266", "created_by": "SwGustav", "created_on": "2022-09-19T18:16:58Z" }, { "id": 1291, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/swgustav_profile_20210218062738.jpg", "comment": "Delayed to Q1 2023", "info_url": "https://twitter.com/jeff_foust/status/1494068275386499072", "created_by": "SwGustav", "created_on": "2022-02-16T22:10:31Z" }, { "id": 37, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "NET 2022", "info_url": "https://spacenews.com/first-dream-chaser-mission-slips-to-2022/", "created_by": "Nosu", "created_on": "2020-11-19T21:01:49Z" } ], "net": "2025-09-30T00:00:00Z", "net_precision": { "id": 10, "name": "Quarter 3", "abbrev": "Q3", "description": "The T-0 is expected in the third quarter of the given year." }, "window_end": "2025-09-30T00:00:00Z", "window_start": "2025-09-30T00:00:00Z", "probability": null, "weather_concerns": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 124, "url": "https://ll.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": 164, "consecutive_successful_launches": 164, "successful_launches": 164, "failed_launches": 0, "pending_launches": 43, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "http://www.ulalaunch.com/", "wiki_url": "http://en.wikipedia.org/wiki/United_Launch_Alliance", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united2520launch2520alliance_logo_20210412195953.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united_launch_a_image_20210412201210.png", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united2520launch2520alliance_nation_20230531043703.jpg" }, "rocket": { "id": 2529, "configuration": { "id": 202, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/202/?format=api", "name": "Vulcan VC4L", "active": true, "reusable": false, "description": "Vulcan Centaur is a two-stage-to-orbit, heavy-lift launch vehicle under development by United Launch Alliance (ULA) since 2014. It is principally designed to meet launch demands for the U.S. government's National Security Space Launch (NSSL) program for use by the United States Space Force and U.S. intelligence agencies for national security satellite launches. It will replace both of ULA's existing launchers (Atlas V and Delta IV Heavy) in this role, as these launchers are retiring.", "family": "Vulcan", "full_name": "Vulcan VC4L", "manufacturer": { "id": 124, "url": "https://ll.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": 164, "consecutive_successful_launches": 164, "successful_launches": 164, "failed_launches": 0, "pending_launches": 43, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "http://www.ulalaunch.com/", "wiki_url": "http://en.wikipedia.org/wiki/United_Launch_Alliance", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united2520launch2520alliance_logo_20210412195953.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united_launch_a_image_20210412201210.png", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united2520launch2520alliance_nation_20230531043703.jpg" }, "program": [], "variant": "VC4L", "alias": "", "min_stage": 2, "max_stage": 2, "length": 67.4, "diameter": 5.4, "maiden_flight": null, "launch_cost": null, "launch_mass": 770, "leo_capacity": 24600, "gto_capacity": 11700, "to_thrust": 13706, "apogee": null, "vehicle_range": null, "image_url": null, "info_url": "https://www.ulalaunch.com/rockets/vulcan-centaur", "wiki_url": "https://en.wikipedia.org/wiki/Vulcan_Centaur", "total_launch_count": 0, "consecutive_successful_launches": 0, "successful_launches": 0, "failed_launches": 0, "pending_launches": 2, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": { "id": 581, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/flight/581/?format=api", "mission_end": null, "destination": "International Space Station", "launch_crew": [], "onboard_crew": [], "landing_crew": [], "spacecraft": { "id": 447, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/447/?format=api", "name": "Dream Chaser Tenacity", "serial_number": null, "is_placeholder": false, "in_space": false, "time_in_space": "P0D", "time_docked": "P0D", "flights_count": 0, "mission_ends_count": 0, "status": { "id": 1, "name": "Active" }, "description": "First operational Dream Chaser.", "spacecraft_config": { "id": 24, "url": "https://ll.thespacedevs.com/2.2.0/config/spacecraft/24/?format=api", "name": "Dream Chaser", "type": { "id": 3, "name": "Spaceplane" }, "agency": { "id": 1020, "url": "https://ll.thespacedevs.com/2.2.0/agencies/1020/?format=api", "name": "Sierra Nevada Corporation", "featured": false, "type": "Commercial", "country_code": "USA", "abbrev": "SNC", "description": "Sierra Nevada Corporation (SNC) is an American, privately held aerospace and national security contractor specializing in aircraft modification and integration, high performance space components and systems, and commercial solutions. The company contracts with the United States Armed Forces, NASA and private spaceflight companies.", "administrator": "CEO: Fatih Ozmen", "founding_year": "1963", "launchers": "", "spacecraft": "", "parent": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/sierra_nevada_c_image_20200821083933.jpeg", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/sierra2520nevada2520corporation_logo_20200821083933.png" }, "in_use": true, "capability": "Cargo transportation to and from the ISS.", "history": "The Dream Chaser Cargo System is an American reusable lifting body spaceplane being developed by Sierra Nevada Corporation (SNC) Space Systems. Originally intended as a crewed vehicle, the Dream Chaser Space System, to be produced after the cargo variant is operational, is capable of carrying up to seven people and cargo to and from low Earth orbit.", "details": "The cargo Dream Chaser will resupply the International Space Station with both pressurized and unpressurized cargo. It will be launched vertically on the Vulcan Centaur rocket, and autonomously land horizontally on conventional runways.", "maiden_flight": null, "height": null, "diameter": null, "human_rated": false, "crew_capacity": 7, "payload_capacity": 5000, "payload_return_capacity": 1750, "flight_life": "Multiple months", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/dream_chaser_image_20200821084247.jpeg", "nation_url": null, "wiki_link": "https://en.wikipedia.org/wiki/Dream_Chaser", "info_link": "https://www.sncorp.com/what-we-do/dream-chaser-space-vehicle/" } }, "landing": { "id": 450, "attempt": true, "success": null, "description": "The Dream Chaser spacecraft will autonomously land at the Shuttle Landing Facility of Kennedy Space Center.", "downrange_distance": 11.5, "location": { "id": 24, "name": "Shuttle Landing Facility", "abbrev": "KTTS", "description": "Airport used for Space Shuttle landings, part of the Kennedy Space Center.", "location": { "id": 27, "url": "https://ll.thespacedevs.com/2.2.0/location/27/?format=api", "name": "Kennedy Space Center, FL, USA", "country_code": "USA", "description": "The John F. Kennedy Space Center, located on Merritt Island, Florida, is one of NASA's ten field centers. Since 1968, KSC has been NASA's primary launch center of American spaceflight, research, and technology. Launch operations for the Apollo, Skylab and Space Shuttle programs were carried out from Kennedy Space Center Launch Complex 39 and managed by KSC. Located on the east coast of Florida, KSC is adjacent to Cape Canaveral Space Force Station (CCSFS).", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_27_20200803142447.jpg", "timezone_name": "America/New_York", "total_launch_count": 260, "total_landing_count": 0 }, "successful_landings": 81 }, "type": { "id": 6, "name": "Horizontal Landing", "abbrev": "HL", "description": "Horizontal landing on a runway or flat surface." } }, "docking_events": [] } }, "mission": { "id": 6519, "name": "Dream Chaser CRS 2 Flight 1", "description": "First flight of the Dream Chaser Spaceplane to the ISS.", "launch_designator": null, "type": "Resupply", "orbit": { "id": 8, "name": "Low Earth Orbit", "abbrev": "LEO" }, "agencies": [ { "id": 44, "url": "https://ll.thespacedevs.com/2.2.0/agencies/44/?format=api", "name": "National Aeronautics and Space Administration", "featured": true, "type": "Government", "country_code": "USA", "abbrev": "NASA", "description": "The National Aeronautics and Space Administration is an independent agency of the executive branch of the United States federal government responsible for the civilian space program, as well as aeronautics and aerospace research. NASA have many launch facilities but most are inactive. The most commonly used pad will be LC-39B at Kennedy Space Center in Florida.", "administrator": "Acting Administrator: James Free", "founding_year": "1958", "launchers": "Space Shuttle | SLS", "spacecraft": "Orion", "launch_library_url": null, "total_launch_count": 141, "consecutive_successful_launches": 11, "successful_launches": 121, "failed_launches": 20, "pending_launches": 6, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "http://www.nasa.gov", "wiki_url": "http://en.wikipedia.org/wiki/National_Aeronautics_and_Space_Administration", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/national2520aeronautics2520and2520space2520administration_logo_20190207032448.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/national2520aeronautics2520and2520space2520administration_image_20190207032448.jpeg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/national2520aeronautics2520and2520space2520administration_nation_20230803040809.jpg" }, { "id": 1020, "url": "https://ll.thespacedevs.com/2.2.0/agencies/1020/?format=api", "name": "Sierra Nevada Corporation", "featured": false, "type": "Commercial", "country_code": "USA", "abbrev": "SNC", "description": "Sierra Nevada Corporation (SNC) is an American, privately held aerospace and national security contractor specializing in aircraft modification and integration, high performance space components and systems, and commercial solutions. The company contracts with the United States Armed Forces, NASA and private spaceflight companies.", "administrator": "CEO: Fatih Ozmen", "founding_year": "1963", "launchers": "", "spacecraft": "", "launch_library_url": null, "total_launch_count": 0, "consecutive_successful_launches": 0, "successful_launches": 0, "failed_launches": 0, "pending_launches": 0, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Sierra_Nevada_Corporation", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/sierra2520nevada2520corporation_logo_20200821083933.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/sierra_nevada_c_image_20200821083933.jpeg", "nation_url": null } ], "info_urls": [], "vid_urls": [] }, "pad": { "id": 29, "url": "https://ll.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://ll.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-prod.nyc3.digitaloceanspaces.com/media/map_images/location_12_20200803142519.jpg", "timezone_name": "America/New_York", "total_launch_count": 1013, "total_landing_count": 62 }, "country_code": "USA", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_29_20200803143528.jpg", "total_launch_count": 114, "orbital_launch_attempt_count": 114 }, "infoURLs": [], "vidURLs": [], "webcast_live": false, "timeline": [], "image": null, "infographic": null, "program": [ { "id": 11, "url": "https://ll.thespacedevs.com/2.2.0/program/11/?format=api", "name": "Commercial Resupply Services", "description": "Commercial Resupply Services (CRS) are a series of flights awarded by NASA for the delivery of cargo and supplies to the International Space Station.The first CRS contracts were signed in 2008 and awarded $1.6 billion to SpaceX for twelve cargo Dragon and $1.9 billion to Orbital Sciences for eight Cygnus flights, covering deliveries to 2016. The Falcon 9 and Antares rockets were also developed under the CRS program to deliver cargo spacecraft to the ISS.", "agencies": [ { "id": 44, "url": "https://ll.thespacedevs.com/2.2.0/agencies/44/?format=api", "name": "National Aeronautics and Space Administration", "type": "Government" }, { "id": 257, "url": "https://ll.thespacedevs.com/2.2.0/agencies/257/?format=api", "name": "Northrop Grumman Space Systems", "type": "Commercial" }, { "id": 1020, "url": "https://ll.thespacedevs.com/2.2.0/agencies/1020/?format=api", "name": "Sierra Nevada Corporation", "type": "Commercial" }, { "id": 121, "url": "https://ll.thespacedevs.com/2.2.0/agencies/121/?format=api", "name": "SpaceX", "type": "Commercial" } ], "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/commercial2520_program_20201129212219.png", "start_date": "2008-12-23T00:00:00Z", "end_date": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Commercial_Resupply_Services#Commercial_Resupply_Services", "mission_patches": [], "type": { "id": 2, "name": "Human Spaceflight" } } ], "orbital_launch_attempt_count": 6974, "location_launch_attempt_count": 1034, "pad_launch_attempt_count": 118, "agency_launch_attempt_count": 168, "orbital_launch_attempt_count_year": 125, "location_launch_attempt_count_year": 40, "pad_launch_attempt_count_year": 4, "agency_launch_attempt_count_year": 4, "pad_turnaround": "P92D", "mission_patches": [], "type": "detailed" }
