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/21561fba-dc41-41b3-9d18-e13339fc3396/?format=api
{ "id": "21561fba-dc41-41b3-9d18-e13339fc3396", "url": "https://lldev.thespacedevs.com/2.0.0/launch/21561fba-dc41-41b3-9d18-e13339fc3396/?format=api", "launch_library_id": null, "slug": "h3-30-igs-optical-diversification-1", "name": "H3-30 | IGS Optical Diversification 1", "status": { "id": 2, "name": "TBD" }, "net": "2027-06-30T00:00:00Z", "window_end": "2027-06-30T00:00:00Z", "window_start": "2027-06-30T00:00:00Z", "inhold": false, "tbdtime": true, "tbddate": true, "probability": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 98, "url": "https://lldev.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": 58, "consecutive_successful_launches": 2, "successful_launches": 56, "failed_launches": 2, "pending_launches": 13, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://www.mhi.com/", "wiki_url": "https://en.wikipedia.org/wiki/Mitsubishi_Heavy_Industries", "logo_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/mitsubishi2520heavy2520industries_logo_20200117065724.png", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/mitsubishi2520heavy2520industries_image_20200117065724.jpg", "nation_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/mitsubishi2520heavy2520industries_nation_20240112111043.jpg" }, "rocket": { "id": 9154, "configuration": { "id": 203, "launch_library_id": 231, "url": "https://lldev.thespacedevs.com/2.0.0/config/launcher/203/?format=api", "name": "H3-30", "description": "The H3 Launch Vehicle is an expendable launch system in development in Japan. H3 rockets are liquid-propellant rockets with strap-on solid rocket boosters and are planned to be launched from the Tanegashima Space Center in Japan. Mitsubishi and the JAXA have been responsible for the design, manufacture, and operation of the H3.", "family": "H3", "full_name": "H3-30", "manufacturer": { "id": 98, "url": "https://lldev.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": 58, "consecutive_successful_launches": 2, "successful_launches": 56, "failed_launches": 2, "pending_launches": 13, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://www.mhi.com/", "wiki_url": "https://en.wikipedia.org/wiki/Mitsubishi_Heavy_Industries", "logo_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/mitsubishi2520heavy2520industries_logo_20200117065724.png", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/mitsubishi2520heavy2520industries_image_20200117065724.jpg", "nation_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/mitsubishi2520heavy2520industries_nation_20240112111043.jpg" }, "program": [], "variant": "30", "alias": "", "min_stage": 2, "max_stage": 2, "length": 63.0, "diameter": 5.27, "maiden_flight": "2026-06-12", "launch_mass": 274, "leo_capacity": null, "gto_capacity": 2300, "to_thrust": 4413, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/h3-30_f6_cft_image_20251028183426.jpg", "info_url": "https://global.jaxa.jp/press/2015/07/20150702_h3.html", "wiki_url": "https://en.wikipedia.org/wiki/H3_(rocket)", "total_launch_count": 1, "consecutive_successful_launches": 1, "successful_launches": 1, "failed_launches": 0, "pending_launches": 3 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 7753, "launch_library_id": null, "name": "IGS Optical Diversification 1", "description": "The IGS Optical Diversification 1 is a Japanese optical reconnaissance satellite. The satellite is operated by the Cabinet Satellite Information Center. The satellite serves both Japan's national defense and civil natural disaster monitoring.", "launch_designator": null, "type": "Government/Top Secret", "orbit": { "id": 17, "name": "Sun-Synchronous Orbit", "abbrev": "SSO" } }, "pad": { "id": 209, "url": "https://lldev.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://lldev.thespacedevs.com/2.0.0/location/26/?format=api", "name": "Tanegashima Space Center, Japan", "country_code": "JPN", "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/location_26_20200803142507.jpg", "total_launch_count": 99, "total_landing_count": 0 }, "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/pad_yoshinobu_launch_complex_lp-2_20230707124715.jpg", "total_launch_count": 18 }, "infoURLs": [], "vidURLs": [], "webcast_live": false, "image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/h3-30_f6_cft_image_20251028183426.jpg", "infographic": null, "program": [], "orbital_launch_attempt_count": 7578, "location_launch_attempt_count": 106, "pad_launch_attempt_count": 25, "agency_launch_attempt_count": 65, "orbital_launch_attempt_count_year": 50, "location_launch_attempt_count_year": 2, "pad_launch_attempt_count_year": 2, "agency_launch_attempt_count_year": 2 }
