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/0c5b798d-2ec4-4e3e-94c0-f2f157231949/?format=api
{ "id": "0c5b798d-2ec4-4e3e-94c0-f2f157231949", "url": "https://ll.thespacedevs.com/2.2.0/launch/0c5b798d-2ec4-4e3e-94c0-f2f157231949/?format=api", "slug": "spaceshiptwo-vss-enterprise-pf03", "flightclub_url": null, "r_spacex_api_id": null, "name": "SpaceShipTwo | VSS Enterprise PF03", "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:58:12Z", "updates": [], "net": "2014-01-10T12:00:00Z", "net_precision": null, "window_end": "2014-01-10T12:00:00Z", "window_start": "2014-01-10T12: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": 2924, "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": 642, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/flight/642/?format=api", "mission_end": "2014-01-10T12:00:00Z", "destination": "Suborbital", "launch_crew": [ { "id": 3483, "role": { "id": 2, "role": "Pilot", "priority": 2 }, "astronaut": { "id": 676, "url": "https://ll.thespacedevs.com/2.2.0/astronaut/676/?format=api", "name": "David Mackay", "type": { "id": 3, "name": "Private" }, "in_space": false, "time_in_space": "PT1H57M30S", "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": "1957-01-01", "date_of_death": null, "nationality": "British", "twitter": null, "instagram": null, "bio": "Astronaut David William Donald Mackay AFC is the British Chief Pilot of Virgin Galactic, and a former RAF test pilot. He is the first native-born Scot to visit space.", "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/david_mackay_image_20220911034224.jpeg", "wiki": "https://en.wikipedia.org/wiki/David_Mackay_(pilot)", "last_flight": "2021-07-11T15:25:30Z", "first_flight": "2012-06-29T12:00:00Z" } }, { "id": 3484, "role": { "id": 2, "role": "Pilot", "priority": 2 }, "astronaut": { "id": 672, "url": "https://ll.thespacedevs.com/2.2.0/astronaut/672/?format=api", "name": "Mark Stucky", "type": { "id": 3, "name": "Private" }, "in_space": false, "time_in_space": "P0D", "status": { "id": 2, "name": "Retired" }, "agency": { "id": 1024, "url": "https://ll.thespacedevs.com/2.2.0/agencies/1024/?format=api", "name": "Virgin Galactic", "type": "Private" }, "date_of_birth": "1958-11-09", "date_of_death": null, "nationality": "American", "twitter": null, "instagram": null, "bio": "Mark P. \"Forger\" Stucky was an American test pilot and commercial astronaut for Virgin Galactic. He left the company in July 2021.", "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/mark_stucky_image_20210522145002.jpg", "wiki": "https://en.wikipedia.org/wiki/Mark_P._Stucky", "last_flight": "2020-06-25T12:00:00Z", "first_flight": "2010-10-28T12:00:00Z" } } ], "onboard_crew": [], "landing_crew": [ { "id": 3485, "role": { "id": 2, "role": "Pilot", "priority": 2 }, "astronaut": { "id": 676, "url": "https://ll.thespacedevs.com/2.2.0/astronaut/676/?format=api", "name": "David Mackay", "type": { "id": 3, "name": "Private" }, "in_space": false, "time_in_space": "PT1H57M30S", "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": "1957-01-01", "date_of_death": null, "nationality": "British", "twitter": null, "instagram": null, "bio": "Astronaut David William Donald Mackay AFC is the British Chief Pilot of Virgin Galactic, and a former RAF test pilot. He is the first native-born Scot to visit space.", "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/david_mackay_image_20220911034224.jpeg", "wiki": "https://en.wikipedia.org/wiki/David_Mackay_(pilot)", "last_flight": "2021-07-11T15:25:30Z", "first_flight": "2012-06-29T12:00:00Z" } }, { "id": 3486, "role": { "id": 2, "role": "Pilot", "priority": 2 }, "astronaut": { "id": 672, "url": "https://ll.thespacedevs.com/2.2.0/astronaut/672/?format=api", "name": "Mark Stucky", "type": { "id": 3, "name": "Private" }, "in_space": false, "time_in_space": "P0D", "status": { "id": 2, "name": "Retired" }, "agency": { "id": 1024, "url": "https://ll.thespacedevs.com/2.2.0/agencies/1024/?format=api", "name": "Virgin Galactic", "type": "Private" }, "date_of_birth": "1958-11-09", "date_of_death": null, "nationality": "American", "twitter": null, "instagram": null, "bio": "Mark P. \"Forger\" Stucky was an American test pilot and commercial astronaut for Virgin Galactic. He left the company in July 2021.", "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/mark_stucky_image_20210522145002.jpg", "wiki": "https://en.wikipedia.org/wiki/Mark_P._Stucky", "last_flight": "2020-06-25T12:00:00Z", "first_flight": "2010-10-28T12: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": 1109, "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": 1341, "name": "VSS Enterprise PF03", "description": "Powered 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": 51, "pad_launch_attempt_count": 32, "agency_launch_attempt_count": 32, "orbital_launch_attempt_count_year": 0, "location_launch_attempt_count_year": 1, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 1, "pad_turnaround": "P30D", "mission_patches": [], "type": "detailed" }
