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/987b33f4-dd2d-4919-8159-f0947d122e01/?format=api
{ "id": "987b33f4-dd2d-4919-8159-f0947d122e01", "url": "https://ll.thespacedevs.com/2.2.0/launch/987b33f4-dd2d-4919-8159-f0947d122e01/?format=api", "slug": "sarge-launch-2-mission-1", "flightclub_url": null, "r_spacex_api_id": null, "name": "SARGE | Launch 2 - \"Mission 1\"", "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": "2019-03-02T16:45:00Z", "net_precision": null, "window_end": "2019-03-02T16:45:00Z", "window_start": "2019-03-02T16:45: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": 2495, "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": 108, "type": "Core", "reused": true, "launcher_flight_number": 2, "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": 138, "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": "2018-08-25T18:15:00Z", "turn_around_time_days": 188, "previous_flight": { "id": "676e30cc-c704-466a-a7f1-8ca4d90f22c8", "name": "SARGE | Launch 1 - \"Pathfinder\"" } } ], "spacecraft_stage": null }, "mission": { "id": 1016, "name": "Mission 1", "description": "The SARGE rocket carried several small research payloads and was intended to reach a peak altitude of 80 kilometers. It only reached a peak altitude of about 20 kilometers before gliding back to a landing about 1.2 kilometers from the launch pad.", "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": "youtube.com", "publisher": "EXOS Aerospace", "title": "SARGE Launch 2", "description": "SARGE Launch 2 - Mar 2, 2019 -\n0:00 Setup\n1:16:23 Clear pad\n1:18:20 Pad cleared\n1:21:45 Launch\n1:25:04 Return descent", "feature_image": "https://i.ytimg.com/vi/1gRuXIGNn6s/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=1gRuXIGNn6s", "type": null, "language": { "id": 1, "name": "English", "code": "en" }, "start_time": "2019-03-02T16:23:17Z", "end_time": "2019-03-02T18:02:37Z" } ], "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": 2, "pad_launch_attempt_count": 2, "agency_launch_attempt_count": 2, "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": "P188DT22H30M", "mission_patches": [], "type": "detailed" }
