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/b149c2f5-82af-4692-a0ba-0ec45bd5273c/?format=api
{ "id": "b149c2f5-82af-4692-a0ba-0ec45bd5273c", "url": "https://ll.thespacedevs.com/2.2.0/launch/b149c2f5-82af-4692-a0ba-0ec45bd5273c/?format=api", "slug": "sarge-launch-4", "flightclub_url": null, "r_spacex_api_id": null, "name": "SARGE | Launch 4", "status": { "id": 4, "name": "Launch Failure", "abbrev": "Failure", "description": "Either the launch vehicle did not reach orbit, or the payload(s) failed to separate." }, "last_updated": "2023-06-14T09:48:57Z", "updates": [], "net": "2019-10-26T17:40:15Z", "net_precision": null, "window_end": "2019-10-26T17:40:15Z", "window_start": "2019-10-26T17:40:15Z", "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": 2569, "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": 111, "type": "Core", "reused": true, "launcher_flight_number": 4, "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": 142, "attempt": true, "success": false, "description": "SARGE will attempt to land after its 4th flight.", "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": "2019-06-29T18:00:18Z", "turn_around_time_days": 118, "previous_flight": { "id": "c2634035-c50d-4878-9a9a-cc7a9ada61c8", "name": "SARGE | Launch 3" } } ], "spacecraft_stage": null }, "mission": { "id": 1048, "name": "SARGE Launch 4", "description": "The 4th launch of EXOS Aerospace's reusable launch vehicle.", "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": [ { "priority": 0, "source": null, "title": "", "description": "Exos Aerospace Systems & Technologies, INC. is your expedited space delivery expert.", "feature_image": null, "url": "https://exosaero.com/", "type": null, "language": null } ], "vidURLs": [ { "priority": 0, "source": null, "publisher": null, "title": "EXOS SARGE Launch 4 LIVE Stream - Oct 26 2019", "description": "Get YouTube without the ads", "feature_image": "https://i.ytimg.com/vi/78osEuHIFBI/hqdefault.jpg", "url": "https://youtu.be/78osEuHIFBI", "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": 4, "pad_launch_attempt_count": 4, "agency_launch_attempt_count": 4, "orbital_launch_attempt_count_year": 0, "location_launch_attempt_count_year": 3, "pad_launch_attempt_count_year": 3, "agency_launch_attempt_count_year": 3, "pad_turnaround": "P118DT23H39M57S", "mission_patches": [], "type": "detailed" }
