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/42370bdb-db93-4212-bda6-d91c177b2ea6/?format=api
{ "id": "42370bdb-db93-4212-bda6-d91c177b2ea6", "url": "https://ll.thespacedevs.com/2.2.0/launch/42370bdb-db93-4212-bda6-d91c177b2ea6/?format=api", "slug": "h-iia-202-hope-emirates-mars-mission", "flightclub_url": null, "r_spacex_api_id": null, "name": "H-IIA 202 | Hope (Emirates Mars Mission)", "status": { "id": 3, "name": "Launch Successful", "abbrev": "Success", "description": "The launch vehicle successfully inserted its payload(s) into the target orbit(s)." }, "last_updated": "2023-07-07T12:52:39Z", "updates": [], "net": "2020-07-19T21:58:14Z", "net_precision": null, "window_end": "2020-07-19T21:58:14Z", "window_start": "2020-07-19T21:58:14Z", "probability": -1, "weather_concerns": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 98, "url": "https://ll.thespacedevs.com/2.2.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": 55, "consecutive_successful_launches": 7, "successful_launches": 54, "failed_launches": 1, "pending_launches": 11, "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-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": 2708, "configuration": { "id": 32, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/32/?format=api", "name": "H-IIA", "active": false, "reusable": false, "description": "H-IIA (H2A) is an active expendable launch system operated by Mitsubishi Heavy Industries (MHI) for the Japan Aerospace Exploration Agency. The liquid-fueled H-IIA rockets have been used to launch satellites into geostationary orbit, to launch a lunar orbiting spacecraft, and to launch Akatsuki, which studied the planet Venus. Launches occur at the Tanegashima Space Center.", "family": "H-II", "full_name": "H-IIA 202", "manufacturer": { "id": 98, "url": "https://ll.thespacedevs.com/2.2.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": 55, "consecutive_successful_launches": 7, "successful_launches": 54, "failed_launches": 1, "pending_launches": 11, "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-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": "202", "alias": "", "min_stage": 2, "max_stage": 2, "length": 53.0, "diameter": 4.0, "maiden_flight": "2001-08-29", "launch_cost": "90000000", "launch_mass": 285, "leo_capacity": 10000, "gto_capacity": 4100, "to_thrust": 2260, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/h-iia_202_lifto_image_20240325123250.jpg", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/H-IIA", "total_launch_count": 35, "consecutive_successful_launches": 35, "successful_launches": 35, "failed_launches": 0, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 913, "name": "Hope (Emirates Mars Mission)", "description": "Hope Mars Mission, also known as Al-Amal, is UAE's first interplanetary space probe. It's an orbiter which will study Martian atmosphere and climate with the help of 3 science instruments: Emirates Exploration imager (EXI), Emirates Mars Ultraviolet Spectrometer (EMUS), and Emirates Mars Infrared Spectrometer (EMIR). These instruments were designed and built in collaboration with University of Colorado, University of California and Arizona State University. Hope is planned to arrive to Mars in February 2021 and has an expected lifetime of 2 years.", "launch_designator": null, "type": "Planetary Science", "orbit": { "id": 6, "name": "Heliocentric N/A", "abbrev": "Helio-N/A" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 41, "url": "https://ll.thespacedevs.com/2.2.0/pad/41/?format=api", "agency_id": 37, "name": "Yoshinobu Launch Complex LP-1", "description": "", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Yoshinobu_Launch_Complex", "map_url": "https://www.google.com/maps?q=30.400813,130.977748", "latitude": "30.400813", "longitude": "130.977748", "location": { "id": 26, "url": "https://ll.thespacedevs.com/2.2.0/location/26/?format=api", "name": "Tanegashima Space Center, Japan", "country_code": "JPN", "description": "The Tanegashima Space Center is the largest rocket-launch complex in Japan. It is located on the southeastern tip of Tanegashima, an island located south of Kyushu, an island and region and Japan. It was established in 1969 when the National Space Development Agency of Japan (NASDA) was formed, and is now run by JAXA. The activities that take place at TNSC include assembly, testing, launching, and tracking satellites, as well as rocket engine firing tests.", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_26_20200803142507.jpg", "timezone_name": "Asia/Tokyo", "total_launch_count": 96, "total_landing_count": 0 }, "country_code": "JPN", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_41_20200803143551.jpg", "total_launch_count": 57, "orbital_launch_attempt_count": 57 }, "infoURLs": [], "vidURLs": [ { "priority": 0, "source": "youtube.com", "publisher": "Hope Mars Mission", "title": "Hope Mars Mission: Live Launch", "description": "Live Launch of the Emirates Mars Mission” Hope Probe” from the Tenaghashima Space Centre in Japan.\nThe Emirates Mars Mission Hope Probe, the first Arab interplanetary mission, has been developed by th...", "feature_image": "https://i.ytimg.com/vi/iLcRd_RZ3Eg/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=iLcRd_RZ3Eg", "type": null, "language": { "id": 1, "name": "English", "code": "en" }, "start_time": "2020-07-19T20:45:03Z", "end_time": "2020-07-19T23:22:43Z" }, { "priority": 10, "source": "youtube.com", "publisher": "Hope Mars Mission", "title": "إطلاق مسبار الأمل – البث المباشر", "description": "مشروع الإمارات لاستكشاف المريخ \"مسبار الأمل\" هو أول مهمة تقوم بها دولة الإمارات العربية المتحدة لاستكشاف كوكب المريخ. وقد تم تصميم \"مسبار الأمل\" للدوران حول كوكب المريخ ودراسة ديناميكية عمل الغلاف الج...", "feature_image": "https://i.ytimg.com/vi/eUPT-1I5Wdk/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=eUPT-1I5Wdk", "type": null, "language": { "id": 10, "name": "Arabic", "code": "ar" }, "start_time": "2020-07-19T19:31:23Z", "end_time": "2020-07-19T23:39:04Z" }, { "priority": 10, "source": "youtube.com", "publisher": "Hope Mars Mission", "title": "Live streaming for the launch of H-IIA Launch Vehicle No.42", "description": "Watch Live streaming for the launch of H-IIA Launch Vehicle No. 42 (H-IIA F42). The H-IIA Launch Vehicle No.42 will carry aboard Emirates Mars Mission's (EMM) Hope probe, developed by the Mohammed bin...", "feature_image": "https://i.ytimg.com/vi/U6pHLJY4Tbo/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=U6pHLJY4Tbo", "type": null, "language": { "id": 1, "name": "English", "code": "en" }, "start_time": "2020-07-19T21:40:14Z", "end_time": "2020-07-19T23:02:04Z" }, { "priority": 10, "source": "youtube.com", "publisher": "Hope Mars Mission", "title": "إطلاق مسبار الأمل – البث المباشر", "description": "مشروع الإمارات لاستكشاف المريخ \"مسبار الأمل\" هو أول مهمة تقوم بها دولة الإمارات العربية المتحدة لاستكشاف كوكب المريخ. وقد تم تصميم \"مسبار الأمل\" للدوران حول كوكب المريخ ودراسة ديناميكية عمل الغلاف الج...", "feature_image": "https://i.ytimg.com/vi/OT1Ttffk7b4/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=OT1Ttffk7b4", "type": null, "language": { "id": 10, "name": "Arabic", "code": "ar" }, "start_time": "2020-07-19T19:30:10Z", "end_time": "2020-07-19T23:40:11Z" }, { "priority": 10, "source": "youtube.com", "publisher": "Hope Mars Mission", "title": "Hope Mars Mission: Live Launch |Without Commentary|", "description": "Live Launch of the Emirates Mars Mission” Hope Probe” from the Tenaghashima Space Centre in Japan.\nThe Emirates Mars Mission Hope Probe, the first Arab interplanetary mission, has been developed by th...", "feature_image": "https://i.ytimg.com/vi/RrIc7ZlwbgE/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=RrIc7ZlwbgE", "type": null, "language": { "id": 1, "name": "English", "code": "en" }, "start_time": "2020-07-19T21:03:23Z", "end_time": "2020-07-19T23:41:08Z" }, { "priority": 10, "source": "youtube.com", "publisher": "DiscoverMHI (Mitsubishi Heavy Industries, Ltd.)", "title": "H-IIAロケット42号機打上げライブ中継 / Live streaming for the launch of H-IIA Launch Vehicle No.42", "description": "打上げ特設サイトもご覧ください：https://spectra.mhi.com/space?l=jp\n2020年7月20日H-IIAロケット42号機（H-IIA・Ｆ42）によるアラブ首長国連邦(UAE)のドバイ政府宇宙機関であるMBRSC (The Mohammed bin Rashid Space Centre)の火星探査機「HOPE」の打上げの模様を中継します。\n\n番組放送時間：06時40分～...", "feature_image": "https://i.ytimg.com/vi/twcVymNjYwU/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=twcVymNjYwU", "type": null, "language": { "id": 1, "name": "English", "code": "en" }, "start_time": "2020-07-19T21:40:14Z", "end_time": "2020-07-19T23:00:11Z" }, { "priority": 10, "source": "youtube.com", "publisher": "Hope Mars Mission", "title": "Live streaming for the launch of H-IIA Launch Vehicle No.42", "description": "Watch Live streaming for the launch of H-IIA Launch Vehicle No. 42 (H-IIA F42). The H-IIA Launch Vehicle No.42 will carry aboard Emirates Mars Mission's (EMM) Hope probe, developed by the Mohammed bin...", "feature_image": "https://i.ytimg.com/vi/U6pHLJY4Tbo/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=U6pHLJY4Tbo", "type": null, "language": { "id": 1, "name": "English", "code": "en" }, "start_time": "2020-07-19T21:40:14Z", "end_time": "2020-07-19T23:02:04Z" } ], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/h-iia_202_lifto_image_20240325123250.jpg", "infographic": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/infographic_images/h-iia25202022_infographic_20200806042051.png", "program": [], "orbital_launch_attempt_count": 5975, "location_launch_attempt_count": 82, "pad_launch_attempt_count": 49, "agency_launch_attempt_count": 43, "orbital_launch_attempt_count_year": 53, "location_launch_attempt_count_year": 3, "pad_launch_attempt_count_year": 2, "agency_launch_attempt_count_year": 3, "pad_turnaround": "P161DT20H24M14S", "mission_patches": [], "type": "detailed" }
