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/52ebc2af-1a42-4cd0-a9a0-09d4f3472ba3/?format=api
{ "id": "52ebc2af-1a42-4cd0-a9a0-09d4f3472ba3", "url": "https://ll.thespacedevs.com/2.2.0/launch/52ebc2af-1a42-4cd0-a9a0-09d4f3472ba3/?format=api", "slug": "spaceshiptwo-vss-enterprise-cf02", "flightclub_url": null, "r_spacex_api_id": null, "name": "SpaceShipTwo | VSS Enterprise CF02", "status": { "id": 3, "name": "Launch Successful", "abbrev": "Success", "description": "The launch vehicle successfully inserted its payload(s) into the target orbit(s)." }, "last_updated": "2023-06-14T08:57:42Z", "updates": [], "net": "2014-08-28T12:00:00Z", "net_precision": null, "window_end": "2014-08-28T12:00:00Z", "window_start": "2014-08-28T12:00:00Z", "probability": null, "weather_concerns": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 1024, "url": "https://ll.thespacedevs.com/2.2.0/agencies/1024/?format=api", "name": "Virgin Galactic", "featured": false, "type": "Private", "country_code": "USA", "abbrev": "VG", "description": "Virgin Galactic is an American spaceflight company within the Virgin Group. It is developing commercial spacecraft and aims to provide suborbital spaceflights to space tourists. Virgin Galactic's suborbital spacecraft are air launched from beneath a carrier airplane known as White Knight Two.", "administrator": "Founder: Richard Branson", "founding_year": "2004", "launchers": "VMS Eve", "spacecraft": "VSS Enterprise | VSS Unity", "launch_library_url": null, "total_launch_count": 67, "consecutive_successful_launches": 11, "successful_launches": 62, "failed_launches": 5, "pending_launches": 0, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://www.virgingalactic.com/", "wiki_url": "https://en.wikipedia.org/wiki/Virgin_Galactic", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/virgin2520galactic_logo_20230509082346.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/virgin_galactic_image_20210522131723.jpeg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/virgin2520galactic_nation_20230617045127.jpg" }, "rocket": { "id": 2928, "configuration": { "id": 465, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/465/?format=api", "name": "SpaceShipTwo", "active": true, "reusable": true, "description": "The Scaled Composites Model 339 SpaceShipTwo (SS2) is an air-launched suborbital spaceplane type designed for space tourism. It is manufactured by The Spaceship Company, a California-based company owned by Virgin Galactic.", "family": "", "full_name": "SpaceShipTwo", "manufacturer": { "id": 1024, "url": "https://ll.thespacedevs.com/2.2.0/agencies/1024/?format=api", "name": "Virgin Galactic", "featured": false, "type": "Private", "country_code": "USA", "abbrev": "VG", "description": "Virgin Galactic is an American spaceflight company within the Virgin Group. It is developing commercial spacecraft and aims to provide suborbital spaceflights to space tourists. Virgin Galactic's suborbital spacecraft are air launched from beneath a carrier airplane known as White Knight Two.", "administrator": "Founder: Richard Branson", "founding_year": "2004", "launchers": "VMS Eve", "spacecraft": "VSS Enterprise | VSS Unity", "launch_library_url": null, "total_launch_count": 67, "consecutive_successful_launches": 11, "successful_launches": 62, "failed_launches": 5, "pending_launches": 0, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://www.virgingalactic.com/", "wiki_url": "https://en.wikipedia.org/wiki/Virgin_Galactic", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/virgin2520galactic_logo_20230509082346.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/virgin_galactic_image_20210522131723.jpeg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/virgin2520galactic_nation_20230617045127.jpg" }, "program": [], "variant": "", "alias": "", "min_stage": 1, "max_stage": 1, "length": 18.0, "diameter": 8.2, "maiden_flight": "2010-10-10", "launch_cost": null, "launch_mass": 9, "leo_capacity": 0, "gto_capacity": 0, "to_thrust": 310, "apogee": 110, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/spaceshiptwo_image_20210522140909.jpeg", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/SpaceShipTwo", "total_launch_count": 67, "consecutive_successful_launches": 11, "successful_launches": 62, "failed_launches": 5, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": { "id": 646, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/flight/646/?format=api", "mission_end": "2014-08-28T12:00:00Z", "destination": "Suborbital", "launch_crew": [ { "id": 3421, "role": { "id": 2, "role": "Pilot", "priority": 2 }, "astronaut": { "id": 671, "url": "https://ll.thespacedevs.com/2.2.0/astronaut/671/?format=api", "name": "Michael Alsbury", "type": { "id": 3, "name": "Private" }, "in_space": false, "time_in_space": "P0D", "status": { "id": 4, "name": "Lost In Flight" }, "agency": { "id": 1024, "url": "https://ll.thespacedevs.com/2.2.0/agencies/1024/?format=api", "name": "Virgin Galactic", "type": "Private" }, "date_of_birth": "1975-03-19", "date_of_death": "2014-10-31", "nationality": "American", "twitter": null, "instagram": null, "bio": "Michael Tyner Alsbury was an American test pilot for Scaled Composites. On October 31, 2014, Alsbury was test flying the Virgin Galactic SpaceShipTwo, VSS Enterprise with Peter Siebold. The craft broke up in-flight, resulting in a total loss of VSS Enterprise, which crashed in the California Mojave Desert.", "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/michael_alsbury_image_20210522144654.jpg", "wiki": "https://en.wikipedia.org/wiki/Michael_Alsbury", "last_flight": "2014-10-31T12:00:00Z", "first_flight": "2010-10-10T12:00:00Z" } }, { "id": 3419, "role": { "id": 2, "role": "Pilot", "priority": 2 }, "astronaut": { "id": 670, "url": "https://ll.thespacedevs.com/2.2.0/astronaut/670/?format=api", "name": "Peter Siebold", "type": { "id": 3, "name": "Private" }, "in_space": false, "time_in_space": "PT12H", "status": { "id": 1, "name": "Active" }, "agency": { "id": 1024, "url": "https://ll.thespacedevs.com/2.2.0/agencies/1024/?format=api", "name": "Virgin Galactic", "type": "Private" }, "date_of_birth": "1971-01-01", "date_of_death": null, "nationality": "American", "twitter": null, "instagram": null, "bio": "Peter Siebold is a member of the Scaled Composites astronaut team. He is their Director of Flight Operations was one of the test pilots for SpaceShipOne and SpaceShipTwo. On October 31, 2014, Peter Siebold and Michael Alsbury were piloting the SpaceShipTwo VSS Enterprise on flight PF04, when the craft came apart in mid-air and then crashed, killing Alsbury and injuring Siebold.", "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/peter_siebold_image_20210522144249.png", "wiki": "https://en.wikipedia.org/wiki/Peter_Siebold", "last_flight": "2014-10-31T12:00:00Z", "first_flight": "2010-10-10T12:00:00Z" } } ], "onboard_crew": [], "landing_crew": [ { "id": 3425, "role": { "id": 2, "role": "Pilot", "priority": 2 }, "astronaut": { "id": 671, "url": "https://ll.thespacedevs.com/2.2.0/astronaut/671/?format=api", "name": "Michael Alsbury", "type": { "id": 3, "name": "Private" }, "in_space": false, "time_in_space": "P0D", "status": { "id": 4, "name": "Lost In Flight" }, "agency": { "id": 1024, "url": "https://ll.thespacedevs.com/2.2.0/agencies/1024/?format=api", "name": "Virgin Galactic", "type": "Private" }, "date_of_birth": "1975-03-19", "date_of_death": "2014-10-31", "nationality": "American", "twitter": null, "instagram": null, "bio": "Michael Tyner Alsbury was an American test pilot for Scaled Composites. On October 31, 2014, Alsbury was test flying the Virgin Galactic SpaceShipTwo, VSS Enterprise with Peter Siebold. The craft broke up in-flight, resulting in a total loss of VSS Enterprise, which crashed in the California Mojave Desert.", "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/michael_alsbury_image_20210522144654.jpg", "wiki": "https://en.wikipedia.org/wiki/Michael_Alsbury", "last_flight": "2014-10-31T12:00:00Z", "first_flight": "2010-10-10T12:00:00Z" } }, { "id": 3423, "role": { "id": 2, "role": "Pilot", "priority": 2 }, "astronaut": { "id": 670, "url": "https://ll.thespacedevs.com/2.2.0/astronaut/670/?format=api", "name": "Peter Siebold", "type": { "id": 3, "name": "Private" }, "in_space": false, "time_in_space": "PT12H", "status": { "id": 1, "name": "Active" }, "agency": { "id": 1024, "url": "https://ll.thespacedevs.com/2.2.0/agencies/1024/?format=api", "name": "Virgin Galactic", "type": "Private" }, "date_of_birth": "1971-01-01", "date_of_death": null, "nationality": "American", "twitter": null, "instagram": null, "bio": "Peter Siebold is a member of the Scaled Composites astronaut team. He is their Director of Flight Operations was one of the test pilots for SpaceShipOne and SpaceShipTwo. On October 31, 2014, Peter Siebold and Michael Alsbury were piloting the SpaceShipTwo VSS Enterprise on flight PF04, when the craft came apart in mid-air and then crashed, killing Alsbury and injuring Siebold.", "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/peter_siebold_image_20210522144249.png", "wiki": "https://en.wikipedia.org/wiki/Peter_Siebold", "last_flight": "2014-10-31T12:00:00Z", "first_flight": "2010-10-10T12:00:00Z" } } ], "spacecraft": { "id": 472, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/472/?format=api", "name": "VSS Enterprise", "serial_number": "N339SS", "is_placeholder": false, "in_space": false, "time_in_space": "PT12H", "time_docked": "P0D", "flights_count": 37, "mission_ends_count": 37, "status": { "id": 3, "name": "Destroyed" }, "description": "VSS Enterprise was the first SpaceShipTwo (SS2) spaceplane, built by Scaled Composites for Virgin Galactic. As of 2004, it was planned to be the first of five commercial suborbital SS2 spacecraft planned by Virgin Galactic. Enterprise was destroyed during a powered test flight on 31 October 2014, killing one pilot, Michael Alsbury, and seriously injuring another, Peter Siebold. An investigation revealed the accident was caused by premature deployment of the \"feathering\" system, the ship's descent device; the NTSB also faulted the spacecraft's design for lacking fail-safe mechanisms that could have deterred or prevented early deployment.", "spacecraft_config": { "id": 27, "url": "https://ll.thespacedevs.com/2.2.0/config/spacecraft/27/?format=api", "name": "SpaceShipTwo", "type": { "id": 3, "name": "Spaceplane" }, "agency": { "id": 1024, "url": "https://ll.thespacedevs.com/2.2.0/agencies/1024/?format=api", "name": "Virgin Galactic", "featured": false, "type": "Private", "country_code": "USA", "abbrev": "VG", "description": "Virgin Galactic is an American spaceflight company within the Virgin Group. It is developing commercial spacecraft and aims to provide suborbital spaceflights to space tourists. Virgin Galactic's suborbital spacecraft are air launched from beneath a carrier airplane known as White Knight Two.", "administrator": "Founder: Richard Branson", "founding_year": "2004", "launchers": "VMS Eve", "spacecraft": "VSS Enterprise | VSS Unity", "parent": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/virgin_galactic_image_20210522131723.jpeg", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/virgin2520galactic_logo_20230509082346.png" }, "in_use": true, "capability": "SpaceShipTwo is carried to its launch altitude by a Scaled Composites White Knight Two, before being released to fly on into the upper atmosphere powered by its rocket engine. It then glides back to Earth and performs a conventional runway landing.", "history": "The spaceship was officially unveiled to the public on 7 December 2009 at the Mojave Air and Space Port in California. On 29 April 2013, after nearly three years of unpowered testing, the first one constructed successfully performed its first powered test flight.", "details": "The Scaled Composites Model 339 SpaceShipTwo is an air-launched suborbital spaceplane type designed for space tourism. It is manufactured by The Spaceship Company, a California-based company owned by Virgin Galactic.", "maiden_flight": "2010-10-10", "height": 18.0, "diameter": 8.2, "human_rated": true, "crew_capacity": 8, "payload_capacity": null, "payload_return_capacity": null, "flight_life": "Short suborbital flights", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/spaceshiptwo_image_20210522133744.jpeg", "nation_url": null, "wiki_link": "https://en.wikipedia.org/wiki/SpaceShipTwo", "info_link": "https://www.virgingalactic.com/" } }, "landing": { "id": 1076, "attempt": true, "success": true, "description": "VSS Enterprise successfully landed back at the Mojave Air and Space Port after this flight.", "downrange_distance": null, "location": { "id": 25, "name": "Mojave Air and Space Port", "abbrev": "KMHV", "description": "Mojave Air and Space Port", "location": null, "successful_landings": 52 }, "type": { "id": 6, "name": "Horizontal Landing", "abbrev": "HL", "description": "Horizontal landing on a runway or flat surface." } }, "docking_events": [] } }, "mission": { "id": 1345, "name": "VSS Enterprise CF02", "description": "Cold flow test flight of VSS Enterprise.", "launch_designator": null, "type": "Test Flight", "orbit": { "id": 15, "name": "Suborbital", "abbrev": "Sub" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 190, "url": "https://ll.thespacedevs.com/2.2.0/pad/190/?format=api", "agency_id": 1024, "name": "Mojave Air and Space Port", "description": null, "info_url": "https://www.mojaveairport.com/", "wiki_url": "https://en.wikipedia.org/wiki/Mojave_Air_and_Space_Port", "map_url": "https://www.google.com/maps?q=35.0594444,-118.1538607", "latitude": "35.0594444", "longitude": "-118.1538607", "location": { "id": 144, "url": "https://ll.thespacedevs.com/2.2.0/location/144/?format=api", "name": "Air launch to Suborbital flight", "country_code": "???", "description": "", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_144_20200803142439.jpg", "timezone_name": "", "total_launch_count": 86, "total_landing_count": 0 }, "country_code": "USA", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_190_20210522160913.jpg", "total_launch_count": 53, "orbital_launch_attempt_count": 0 }, "infoURLs": [], "vidURLs": [], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/spaceshiptwo_image_20210522140909.jpeg", "infographic": null, "program": [], "orbital_launch_attempt_count": null, "location_launch_attempt_count": 54, "pad_launch_attempt_count": 35, "agency_launch_attempt_count": 35, "orbital_launch_attempt_count_year": 0, "location_launch_attempt_count_year": 4, "pad_launch_attempt_count_year": 4, "agency_launch_attempt_count_year": 4, "pad_turnaround": "P30D", "mission_patches": [], "type": "detailed" }
