Launch Instance
API endpoint that returns all Launch objects or a single launch.
EXAMPLE - /launch/
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'
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.0.0/launch/69ebbcd2-b257-4070-9ef9-21e7d1f8a883/?format=api
{ "id": "69ebbcd2-b257-4070-9ef9-21e7d1f8a883", "url": "https://ll.thespacedevs.com/2.0.0/launch/69ebbcd2-b257-4070-9ef9-21e7d1f8a883/?format=api", "launch_library_id": null, "slug": "h3-24-martian-moon-explorer-mmx", "name": "H3-24 | Martian Moon eXplorer (MMX)", "status": { "id": 2, "name": "TBD" }, "net": "2026-12-31T00:00:00Z", "window_end": "2026-12-31T00:00:00Z", "window_start": "2026-12-31T00:00:00Z", "inhold": false, "tbdtime": true, "tbddate": true, "probability": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 98, "url": "https://ll.thespacedevs.com/2.0.0/agencies/98/?format=api", "name": "Mitsubishi Heavy Industries", "featured": false, "type": "Commercial", "country_code": "JPN", "abbrev": "MHI", "description": "Mitsubishi Heavy Industries, Ltd. is a Japanese multinational engineering, electrical equipment and electronics company headquartered in Tokyo, Japan. MHI is one of the core companies of the Mitsubishi Group.\r\n\r\nMHI's products include aerospace components, air conditioners, aircraft, automotive components, forklift trucks, hydraulic equipment, machine tools, missiles, power generation equipment, printing machines, ships and space launch vehicles. Through its defense-related activities, it is the world's 23rd-largest defense contractor measured by 2011 defense revenues and the largest based in Japan.", "administrator": "President: Seiji Izumisawa", "founding_year": "1884", "launchers": "H-I, H-II, H-III", "spacecraft": "Kounotori | HTV", "launch_library_url": null, "total_launch_count": 54, "consecutive_successful_launches": 6, "successful_launches": 53, "failed_launches": 1, "pending_launches": 13, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://www.mhi.com/", "wiki_url": "http://en.wikipedia.org/wiki/Mitsubishi_Heavy_Industries", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/mitsubishi2520heavy2520industries_logo_20200117065724.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/mitsubishi2520heavy2520industries_image_20200117065724.jpg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/mitsubishi2520heavy2520industries_nation_20240112111043.jpg" }, "rocket": { "id": 7769, "configuration": { "id": 204, "launch_library_id": 233, "url": "https://ll.thespacedevs.com/2.0.0/config/launcher/204/?format=api", "name": "H3-24", "description": "The H3 Launch Vehicle is an expendable launch system in development in Japan.\r\nEach H3 booster configuration has a two-digit and a letter designation that indicates the features of that configuration. The first digit represents the number of LE-9 engines on the main stage, either \"2\" or \"3\". The second digit indicates the number of SRB-3 solid rocket boosters attached to the base of the rocket, and can be \"0\", \"2\" or \"4\". All layouts of solid boosters are symmetrical. The letter in the end shows the length of the payload fairing, either short \"S\" or long \"L\". For example, an H3-24L has two engines, four solid rocket boosters, and a long fairing, whereas an H3-30S has three engines, no solid rocket boosters, and a short fairing.", "family": "H3", "full_name": "H3-24", "manufacturer": { "id": 98, "url": "https://ll.thespacedevs.com/2.0.0/agencies/98/?format=api", "name": "Mitsubishi Heavy Industries", "featured": false, "type": "Commercial", "country_code": "JPN", "abbrev": "MHI", "description": "Mitsubishi Heavy Industries, Ltd. is a Japanese multinational engineering, electrical equipment and electronics company headquartered in Tokyo, Japan. MHI is one of the core companies of the Mitsubishi Group.\r\n\r\nMHI's products include aerospace components, air conditioners, aircraft, automotive components, forklift trucks, hydraulic equipment, machine tools, missiles, power generation equipment, printing machines, ships and space launch vehicles. Through its defense-related activities, it is the world's 23rd-largest defense contractor measured by 2011 defense revenues and the largest based in Japan.", "administrator": "President: Seiji Izumisawa", "founding_year": "1884", "launchers": "H-I, H-II, H-III", "spacecraft": "Kounotori | HTV", "launch_library_url": null, "total_launch_count": 54, "consecutive_successful_launches": 6, "successful_launches": 53, "failed_launches": 1, "pending_launches": 13, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://www.mhi.com/", "wiki_url": "http://en.wikipedia.org/wiki/Mitsubishi_Heavy_Industries", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/mitsubishi2520heavy2520industries_logo_20200117065724.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/mitsubishi2520heavy2520industries_image_20200117065724.jpg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/mitsubishi2520heavy2520industries_nation_20240112111043.jpg" }, "program": [], "variant": "24", "alias": "", "min_stage": 2, "max_stage": 2, "length": 63.0, "diameter": 5.27, "maiden_flight": null, "launch_mass": null, "leo_capacity": null, "gto_capacity": 7900, "to_thrust": 12142, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/h-iii_image_20221104084531.jpeg", "info_url": "http://global.jaxa.jp/press/2015/07/20150702_h3.html", "wiki_url": "https://en.wikipedia.org/wiki/H3_(rocket)", "total_launch_count": 0, "consecutive_successful_launches": 0, "successful_launches": 0, "failed_launches": 0, "pending_launches": 5 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 6287, "launch_library_id": null, "name": "Martian Moon eXplorer (MMX)", "description": "MMX is a Japanese scientific mission to land on Phobos, one of the two moons of Mars, to collect samples before bringing them back to Earth.\r\n\r\nThe mission includes a small French/German rover to explore the surface of Phobos.", "launch_designator": null, "type": "Planetary Science", "orbit": { "id": 19, "name": "Mars Orbit", "abbrev": "Mars" } }, "pad": { "id": 209, "url": "https://ll.thespacedevs.com/2.0.0/pad/209/?format=api", "agency_id": 37, "name": "Yoshinobu Launch Complex LP-2", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Yoshinobu_Launch_Complex", "map_url": "https://www.google.com/maps?q=30.400938,130.97564", "latitude": "30.400938", "longitude": "130.97564", "location": { "id": 26, "url": "https://ll.thespacedevs.com/2.0.0/location/26/?format=api", "name": "Tanegashima Space Center, Japan", "country_code": "JPN", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_26_20200803142507.jpg", "total_launch_count": 94, "total_landing_count": 0 }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_yoshinobu_launch_complex_lp-2_20230707124715.jpg", "total_launch_count": 14 }, "infoURLs": [], "vidURLs": [], "webcast_live": false, "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/h-iii_image_20221104084531.jpeg", "infographic": null, "program": [], "orbital_launch_attempt_count": 7199, "location_launch_attempt_count": 105, "pad_launch_attempt_count": 24, "agency_launch_attempt_count": 64, "orbital_launch_attempt_count_year": 86, "location_launch_attempt_count_year": 5, "pad_launch_attempt_count_year": 5, "agency_launch_attempt_count_year": 5 }
