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/aa429cd7-a947-430a-9956-72dff1ab9c60/?format=api
{ "id": "aa429cd7-a947-430a-9956-72dff1ab9c60", "url": "https://ll.thespacedevs.com/2.2.0/launch/aa429cd7-a947-430a-9956-72dff1ab9c60/?format=api", "slug": "h3-22-dsn-3-kirameki-3", "flightclub_url": null, "r_spacex_api_id": null, "name": "H3-22 | DSN 3 (Kirameki 3)", "status": { "id": 3, "name": "Launch Successful", "abbrev": "Success", "description": "The launch vehicle successfully inserted its payload(s) into the target orbit(s)." }, "last_updated": "2024-11-05T04:18:22Z", "updates": [ { "id": 9076, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Launch success.", "info_url": "https://global.jaxa.jp/press/2024/11/20241104-1_e.html", "created_by": "Cosmic_Penguin", "created_on": "2024-11-04T09:56:00Z" }, { "id": 9072, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Spacecraft separation confirmed.", "info_url": "https://www.youtube.com/watch?v=O4-8AoaSzbQ", "created_by": "Cosmic_Penguin", "created_on": "2024-11-04T07:21:00Z" }, { "id": 9071, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Liftoff.", "info_url": "https://www.youtube.com/watch?v=O4-8AoaSzbQ", "created_by": "Cosmic_Penguin", "created_on": "2024-11-04T06:48:00Z" }, { "id": 9070, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/ll2_profile_20230311134739.png", "comment": "Official Webcast by JAXA | 宇宙航空研究開発機構 has started", "info_url": "https://www.youtube.com/watch?v=O4-8AoaSzbQ", "created_by": "LL2", "created_on": "2024-11-04T06:02:00Z" }, { "id": 9055, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Tweaked launch window.", "info_url": "https://www.jaxa.jp/press/2024/11/20241102-1_j.html", "created_by": "Cosmic_Penguin", "created_on": "2024-11-02T06:12:00Z" }, { "id": 9046, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Rescheduled for November 4 due to launch site weather.", "info_url": "https://x.com/mhi_groupjp/status/1851881940032663623", "created_by": "Cosmic_Penguin", "created_on": "2024-10-31T07:36:00Z" }, { "id": 9034, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Rescheduled for November 2.", "info_url": "https://x.com/mhi_groupjp/status/1851494448284516392", "created_by": "Cosmic_Penguin", "created_on": "2024-10-30T05:44:00Z" }, { "id": 9016, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Delayed due to unfavorable launch weather conditions; new launch date TBD.", "info_url": "https://www.jaxa.jp/press/2024/10/20241028-1_j.html", "created_by": "Cosmic_Penguin", "created_on": "2024-10-28T05:06:00Z" }, { "id": 8958, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Delayed to October 30 due to 2nd stage engine valve replacement.", "info_url": "https://www.jaxa.jp/press/2024/10/20241022-2_j.html", "created_by": "Cosmic_Penguin", "created_on": "2024-10-22T08:16:00Z" }, { "id": 8717, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Rescheduled for October 26 due to delays with previous H-IIA launch.", "info_url": "https://global.jaxa.jp/press/2024/09/20240927-2_e.html", "created_by": "Cosmic_Penguin", "created_on": "2024-09-27T08:15:00Z" }, { "id": 8412, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "GO for launch.", "info_url": "https://www.jaxa.jp/press/2024/08/20240827-1_j.html", "created_by": "Cosmic_Penguin", "created_on": "2024-08-27T08:22:58Z" }, { "id": 6226, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Tweaked approximate launch date per launch manifest (P.129 of source).", "info_url": "https://www8.cao.go.jp/space/comittee/dai108/siryou2_2.pdf", "created_by": "Cosmic_Penguin", "created_on": "2024-01-09T14:28:05Z" } ], "net": "2024-11-04T06:48:00Z", "net_precision": { "id": 0, "name": "Second", "abbrev": "SEC", "description": "The T-0 is accurate to the second." }, "window_end": "2024-11-04T08:16:00Z", "window_start": "2024-11-04T06:48:00Z", "probability": null, "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": 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": 7772, "configuration": { "id": 486, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/486/?format=api", "name": "H3-22", "active": true, "reusable": false, "description": "The H3 Launch Vehicle is a Japanese expendable launch system.\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-22", "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": 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": "22", "alias": "", "min_stage": 2, "max_stage": 2, "length": 63.0, "diameter": 5.27, "maiden_flight": "2023-03-07", "launch_cost": "50000000", "launch_mass": null, "leo_capacity": null, "gto_capacity": 5400, "to_thrust": 7542, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/h3-22_image_20230307130808.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": 5, "consecutive_successful_launches": 4, "successful_launches": 4, "failed_launches": 1, "pending_launches": 3, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 6290, "name": "DSN 3 (Kirameki 3)", "description": "DSN 3, also known as Kirameki 3, is a geostationary communications satellite to be used for military communications by the Japanese military.", "launch_designator": null, "type": "Communications", "orbit": { "id": 2, "name": "Geostationary Transfer Orbit", "abbrev": "GTO" }, "agencies": [ { "id": 1073, "url": "https://ll.thespacedevs.com/2.2.0/agencies/1073/?format=api", "name": "DSN Corporation", "featured": false, "type": "Commercial", "country_code": "JPN", "abbrev": "", "description": "DSN Corporation Japanese: 株式会社ディー・エス・エヌ is a corporation owned by SKY Perfect JSAT Group, NEC and NTT Com. It was founded on December 19, 2012 for the sole purpose of acting as an investment vehicle in the private finance initiative that would handle the Japanese military X-band DSN satellite network from 2015 to 2031.", "administrator": null, "founding_year": "2012", "launchers": "", "spacecraft": "", "launch_library_url": null, "total_launch_count": 0, "consecutive_successful_launches": 0, "successful_launches": 0, "failed_launches": 0, "pending_launches": 0, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://en.wikipedia.org/wiki/DSN_Corporation", "wiki_url": null, "logo_url": null, "image_url": null, "nation_url": null } ], "info_urls": [], "vid_urls": [] }, "pad": { "id": 209, "url": "https://ll.thespacedevs.com/2.2.0/pad/209/?format=api", "agency_id": 37, "name": "Yoshinobu Launch Complex LP-2", "description": "", "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.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": 94, "total_landing_count": 0 }, "country_code": "JPN", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_yoshinobu_launch_complex_lp-2_20230707124715.jpg", "total_launch_count": 14, "orbital_launch_attempt_count": 14 }, "infoURLs": [], "vidURLs": [ { "priority": 10, "source": "youtube.com", "publisher": "JAXA | 宇宙航空研究開発機構", "title": "Xバンド防衛通信衛星「きらめき3号」／H3ロケット4号機打上げライブ中継", "description": "Xバンド防衛通信衛星「きらめき3号」を搭載したH3ロケット4号機の打上げの様子を、種子島宇宙センターよりライブ配信します。\nThe live coverage of the launch of the 4th H3 Launch Vehicle (H3 F4: Flight No.4) with X-band defense communication satellite-3 onboard fr...", "feature_image": "https://i.ytimg.com/vi/O4-8AoaSzbQ/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=O4-8AoaSzbQ", "type": { "id": 1, "name": "Official Webcast" }, "language": { "id": 6, "name": "Japanese", "code": "jp" }, "start_time": "2024-11-04T06:00:11Z", "end_time": "2024-11-04T07:30:24Z" }, { "priority": 11, "source": "youtube.com", "publisher": "NVS", "title": "H３ロケット4号機 Xバンド防衛通信衛星「きらめき3号」打上げ / H3 Rocket F4 X-band defense communication satellite-3 Launch", "description": "打上げ予定日（Launch Date）：2024.11.4\n打上げ予定時刻（Launch Time）：TBD +0900 (JST)\n打上げ可能時間帯（Window）：15:48～17:30 +0900 (JST)\n予備期間（Preliminary duration）： 2024/10/31～2024/11/30\nペイロード衛星（Payload）： Xバンド防衛通信衛星「きらめき3号」（X-ba...", "feature_image": "https://i.ytimg.com/vi/EifwMnQrYRg/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=EifwMnQrYRg", "type": { "id": 3, "name": "Unofficial Webcast" }, "language": { "id": 6, "name": "Japanese", "code": "jp" }, "start_time": "2024-11-04T05:45:28Z", "end_time": "2024-11-04T07:10:02Z" } ], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/h3-22_image_20230307130808.jpeg", "infographic": null, "program": [], "orbital_launch_attempt_count": 6791, "location_launch_attempt_count": 93, "pad_launch_attempt_count": 13, "agency_launch_attempt_count": 53, "orbital_launch_attempt_count_year": 202, "location_launch_attempt_count_year": 5, "pad_launch_attempt_count_year": 3, "agency_launch_attempt_count_year": 5, "pad_turnaround": "P126DT3H41M18S", "mission_patches": [], "type": "detailed" }
