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/758ee568-0d39-49a6-8b2e-9bdf2af2a5d8/?format=api
{ "id": "758ee568-0d39-49a6-8b2e-9bdf2af2a5d8", "url": "https://ll.thespacedevs.com/2.2.0/launch/758ee568-0d39-49a6-8b2e-9bdf2af2a5d8/?format=api", "slug": "spaceshiptwo-vss-unity-gf01", "flightclub_url": null, "r_spacex_api_id": null, "name": "SpaceShipTwo | VSS Unity GF01", "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:14Z", "updates": [], "net": "2016-12-03T12:00:00Z", "net_precision": null, "window_end": "2016-12-03T12:00:00Z", "window_start": "2016-12-03T12: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": 2935, "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": 653, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/flight/653/?format=api", "mission_end": "2016-12-03T12:00:00Z", "destination": "Suborbital", "launch_crew": [ { "id": 3296, "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": 3294, "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": 3299, "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": 3297, "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": 473, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/473/?format=api", "name": "VSS Unity", "serial_number": "N202VG", "is_placeholder": false, "in_space": false, "time_in_space": "PT4H3M43S", "time_docked": "P0D", "flights_count": 30, "mission_ends_count": 30, "status": { "id": 2, "name": "Retired" }, "description": "VSS Unity, previously referred to as VSS Voyager, is a SpaceShipTwo-class suborbital rocket-powered crewed spaceplane. It is the second SpaceShipTwo to be built and will be used as part of the Virgin Galactic fleet.", "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": 1117, "attempt": true, "success": true, "description": "VSS Unity 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": 1352, "name": "VSS Unity GF01", "description": "First free glide test flight of VSS Unity.", "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": 61, "pad_launch_attempt_count": 42, "agency_launch_attempt_count": 42, "orbital_launch_attempt_count_year": 0, "location_launch_attempt_count_year": 5, "pad_launch_attempt_count_year": 5, "agency_launch_attempt_count_year": 5, "pad_turnaround": "P3D", "mission_patches": [], "type": "detailed" }
