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/a2bc4f36-bdbd-4daf-9663-9382bc11f0cb/?format=api
{ "id": "a2bc4f36-bdbd-4daf-9663-9382bc11f0cb", "url": "https://ll.thespacedevs.com/2.2.0/launch/a2bc4f36-bdbd-4daf-9663-9382bc11f0cb/?format=api", "slug": "h-iia-202-igs-radar-5", "flightclub_url": null, "r_spacex_api_id": null, "name": "H-IIA 202 | IGS Radar 5", "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-06-14T03:53:08Z", "updates": [], "net": "2017-03-17T01:20:00Z", "net_precision": null, "window_end": "2017-03-17T01:33:57Z", "window_start": "2017-03-17T01:20:00Z", "probability": null, "weather_concerns": null, "holdreason": "", "failreason": null, "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": 56, "consecutive_successful_launches": 0, "successful_launches": 54, "failed_launches": 2, "pending_launches": 9, "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": 1991, "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": 56, "consecutive_successful_launches": 0, "successful_launches": 54, "failed_launches": 2, "pending_launches": 9, "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": 395, "name": "IGS Radar 5", "description": "IGS Radar is a family of Japanese radar reconnaissance satellites that serve both Japan's national defense and civil natural disaster monitoring. IGS Radar 5 is the fifth generation of satellites. Equipped with synthetic aperture radar, it is able to image targets even in darkness and bad weather.", "launch_designator": null, "type": "Government/Top Secret", "orbit": { "id": 17, "name": "Sun-Synchronous Orbit", "abbrev": "SSO" }, "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": 97, "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": "産経ニュース", "title": "情報収集衛星「レーダー5号」打ち上げ成功", "description": "政府の情報収集衛星レーダー5号機を搭載したH2Aロケット33号機が17日午前10時20分、鹿児島県の種子島宇宙センターから打ち上げられた。衛星を予定の軌道に投入し、打ち上げは成功した。物体の識別能力が従来の約2倍とみられる新機種で、正常に機能すれば夜間などの監視能力が大きく向上する。\n\n 情報収集衛星は北朝鮮の軍事施設などを監視する事実上の偵察衛星。夜間や曇りでも地上を観測できるタイプのレーダー衛...", "feature_image": "https://i.ytimg.com/vi/OrFliJY_u88/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=OrFliJY_u88", "type": { "id": 6, "name": "Recap" }, "language": { "id": 6, "name": "Japanese", "code": "jp" }, "start_time": "2017-03-17T03:26:14Z", "end_time": "2017-03-17T03:27:35Z" }, { "priority": 0, "source": "youtube.com", "publisher": "NVS", "title": "H-IIAロケット33号機打上げ(現地中継)", "description": "打上げの瞬間は 0:51:00~です。 \nH-IIAロケット33号機による情報収集衛星 レーダー5号機の打上げを中継します。\n\n 打上げ時刻:2017/3/17 10:20:00 (JST)\n 打上げ可能時間帯:2017/3/17 10:20:00~10:33:57 (JST)\n 打上げ予備期間:2017/3/18~4/10\n\nペイロード:情報収集衛星 レーダー5号機 (IGS )\n\n 最新情報...", "feature_image": "https://i.ytimg.com/vi/XUbARjJfgvI/hqdefault.jpg", "url": "https://www.youtube.com/watch?v=XUbARjJfgvI", "type": { "id": 3, "name": "Unofficial Webcast" }, "language": { "id": 6, "name": "Japanese", "code": "jp" }, "start_time": "2017-03-17T00:28:19Z", "end_time": "2017-03-17T02:11:06Z" } ], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/h-iia_202_lifto_image_20240325123250.jpg", "infographic": null, "program": [], "orbital_launch_attempt_count": 5631, "location_launch_attempt_count": 70, "pad_launch_attempt_count": 40, "agency_launch_attempt_count": 32, "orbital_launch_attempt_count_year": 16, "location_launch_attempt_count_year": 2, "pad_launch_attempt_count_year": 2, "agency_launch_attempt_count_year": 2, "pad_turnaround": "P51DT17H36M", "mission_patches": [], "type": "detailed" }