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/676e30cc-c704-466a-a7f1-8ca4d90f22c8/?format=api
{ "id": "676e30cc-c704-466a-a7f1-8ca4d90f22c8", "url": "https://ll.thespacedevs.com/2.2.0/launch/676e30cc-c704-466a-a7f1-8ca4d90f22c8/?format=api", "slug": "sarge-launch-1-pathfinder", "flightclub_url": null, "r_spacex_api_id": null, "name": "SARGE | Launch 1 - \"Pathfinder\"", "status": { "id": 7, "name": "Launch was a Partial Failure", "abbrev": "Partial Failure", "description": "Either the launch vehicle reached orbit but did not deliver its payload in the targeted orbit, or an exceptional event made it impossible to consider the mission a success." }, "last_updated": "2023-06-14T09:48:57Z", "updates": [], "net": "2018-08-25T18:15:00Z", "net_precision": null, "window_end": "2018-08-25T18:15:00Z", "window_start": "2018-08-25T18:15:00Z", "probability": null, "weather_concerns": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 1001, "url": "https://ll.thespacedevs.com/2.2.0/agencies/1001/?format=api", "name": "EXOS Aerospace", "featured": false, "type": "Commercial", "country_code": "USA", "abbrev": "EXOS", "description": "Exos Aerospace Systems & Technologies is an aerospace manufacturer and developer of reusable launch systems intended to support unmanned orbital spaceflight launches, and is based in Caddo Mills, Texas.", "administrator": "President: David Mitchell", "founding_year": "2014", "launchers": "", "spacecraft": "", "launch_library_url": null, "total_launch_count": 4, "consecutive_successful_launches": 0, "successful_launches": 0, "failed_launches": 4, "pending_launches": 0, "consecutive_successful_landings": 0, "successful_landings": 3, "failed_landings": 1, "attempted_landings": 4, "info_url": "https://exosaero.com/", "wiki_url": "https://en.wikipedia.org/wiki/Exos_Aerospace", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/exos2520aerospace_logo_20190629155319.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/exos2520aerospace_image_20190629155318.jpg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/exos2520aerospace_nation_20190629165337.jpg" }, "rocket": { "id": 2494, "configuration": { "id": 197, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/197/?format=api", "name": "SARGE", "active": true, "reusable": true, "description": "The SARGE vehicle is based on the STIG B platform developed as part of Armadillo Aerospace's lunar lander program.\r\n\r\nThe SARGE vehicle employs a LOX-ethanol propulsion module based on the LE23000FC series engines, producing approximately 5500 lbs of thrust.\r\n\r\nThe airframe is a reusable sounding rocket with a 20 inches (51 cm) diameter, and is 36 feet (11 m) tall.\r\nHelium pressurant cold gas thrusters provide attitude control for pitch-roll-yaw and pointing capability.\r\n\r\nPayload must fit inside a 20 inches (51 cm) diameter cylinder, be no more than 36 inches (91 cm) tall (in its standard configuration) and weigh no more than 50 kilograms (110 lb).", "family": "", "full_name": "SARGE", "manufacturer": { "id": 1001, "url": "https://ll.thespacedevs.com/2.2.0/agencies/1001/?format=api", "name": "EXOS Aerospace", "featured": false, "type": "Commercial", "country_code": "USA", "abbrev": "EXOS", "description": "Exos Aerospace Systems & Technologies is an aerospace manufacturer and developer of reusable launch systems intended to support unmanned orbital spaceflight launches, and is based in Caddo Mills, Texas.", "administrator": "President: David Mitchell", "founding_year": "2014", "launchers": "", "spacecraft": "", "launch_library_url": null, "total_launch_count": 4, "consecutive_successful_launches": 0, "successful_launches": 0, "failed_launches": 4, "pending_launches": 0, "consecutive_successful_landings": 0, "successful_landings": 3, "failed_landings": 1, "attempted_landings": 4, "info_url": "https://exosaero.com/", "wiki_url": "https://en.wikipedia.org/wiki/Exos_Aerospace", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/exos2520aerospace_logo_20190629155319.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/exos2520aerospace_image_20190629155318.jpg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/exos2520aerospace_nation_20190629165337.jpg" }, "program": [], "variant": "", "alias": "", "min_stage": 1, "max_stage": 1, "length": 11.0, "diameter": 0.51, "maiden_flight": "2018-08-25", "launch_cost": null, "launch_mass": null, "leo_capacity": null, "gto_capacity": null, "to_thrust": 24, "apogee": 80, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/sarge_image_20191026175316.jpg", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Exos_Aerospace#SARGE", "total_launch_count": 4, "consecutive_successful_launches": 0, "successful_launches": 0, "failed_launches": 4, "pending_launches": 0, "attempted_landings": 4, "successful_landings": 3, "failed_landings": 1, "consecutive_successful_landings": 0 }, "launcher_stage": [ { "id": 107, "type": "Core", "reused": false, "launcher_flight_number": 1, "launcher": { "id": 67, "url": "https://ll.thespacedevs.com/2.2.0/launcher/67/?format=api", "details": "Sarge 1 is the first SARGE reusable sounding rocket.", "flight_proven": true, "serial_number": "SARGE 1", "status": "destroyed", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/67_image_20190629182855.jpg", "successful_landings": 3, "attempted_landings": 4, "flights": 4, "last_launch_date": "2019-10-26T17:40:15Z", "first_launch_date": "2018-08-25T18:15:00Z" }, "landing": { "id": 137, "attempt": true, "success": true, "description": "Sarge 1 successfully landed back on Earth.", "downrange_distance": null, "location": { "id": 13, "name": "Spaceport America", "abbrev": "SA", "description": "FAA-licensed spaceport in New Mexico.", "location": { "id": 31, "url": "https://ll.thespacedevs.com/2.2.0/location/31/?format=api", "name": "Spaceport America, NM, USA", "country_code": "USA", "description": "Spaceport America is an FAA-licensed spaceport located in the Jornada del Muerto desert basin north of Las Cruces, New Mexico, and southeast of Truth or Consequences. With Virgin Galactic's launch of the VSS Unity, with three people aboard, on May 22, 2021, New Mexico became the third US state to launch humans into space after California and Florida.", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_31_20200803142505.jpg", "timezone_name": "America/Denver", "total_launch_count": 4, "total_landing_count": 4 }, "successful_landings": 17 }, "type": { "id": 4, "name": "Parachute Landing", "abbrev": "PCL", "description": "Unpowered landing using parachute(s)." } }, "previous_flight_date": null, "turn_around_time_days": null, "previous_flight": null } ], "spacecraft_stage": null }, "mission": { "id": 1015, "name": "Pathfinder", "description": "First test launch of the SARGE reusable sounding rocket.", "launch_designator": null, "type": "Suborbital", "orbit": { "id": 15, "name": "Suborbital", "abbrev": "Sub" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 105, "url": "https://ll.thespacedevs.com/2.2.0/pad/105/?format=api", "agency_id": 1001, "name": "Vertical Launch Area", "description": null, "info_url": null, "wiki_url": null, "map_url": "https://www.google.com/maps?q=32.9901856,-106.9750602", "latitude": "32.9901856", "longitude": "-106.9750602", "location": { "id": 31, "url": "https://ll.thespacedevs.com/2.2.0/location/31/?format=api", "name": "Spaceport America, NM, USA", "country_code": "USA", "description": "Spaceport America is an FAA-licensed spaceport located in the Jornada del Muerto desert basin north of Las Cruces, New Mexico, and southeast of Truth or Consequences. With Virgin Galactic's launch of the VSS Unity, with three people aboard, on May 22, 2021, New Mexico became the third US state to launch humans into space after California and Florida.", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_31_20200803142505.jpg", "timezone_name": "America/Denver", "total_launch_count": 4, "total_landing_count": 4 }, "country_code": "USA", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_105_20200803143432.jpg", "total_launch_count": 4, "orbital_launch_attempt_count": 0 }, "infoURLs": [], "vidURLs": [ { "priority": 0, "source": null, "publisher": null, "title": "SARGE Launch 1 - “Pathfinder\"", "description": "Exos Aerospace, It takes a team to fly a Rocket! Thank you to all of the laborers, participants, and Investors, to everyone that had the Faith to see this th...", "feature_image": "https://i.ytimg.com/vi/_G9dJ3IQQVk/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=_G9dJ3IQQVk", "type": null, "language": null, "start_time": null, "end_time": null } ], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/sarge_image_20191026175316.jpg", "infographic": null, "program": [], "orbital_launch_attempt_count": null, "location_launch_attempt_count": 1, "pad_launch_attempt_count": 1, "agency_launch_attempt_count": 1, "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": "P0D", "mission_patches": [], "type": "detailed" }
