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/03b1016f-0823-46f9-85d8-8383aeb02f02/?format=api
{ "id": "03b1016f-0823-46f9-85d8-8383aeb02f02", "url": "https://ll.thespacedevs.com/2.2.0/launch/03b1016f-0823-46f9-85d8-8383aeb02f02/?format=api", "slug": "h-iia-202-himawari-9", "flightclub_url": null, "r_spacex_api_id": null, "name": "H-IIA 202 | Himawari-9", "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:10Z", "updates": [], "net": "2016-11-02T06:20:00Z", "net_precision": null, "window_end": "2016-11-02T09:18:00Z", "window_start": "2016-11-02T06:20:00Z", "probability": -1, "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": 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": 1959, "configuration": { "id": 32, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/32/?format=api", "name": "H-IIA", "active": true, "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": 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": "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": 34, "consecutive_successful_launches": 34, "successful_launches": 34, "failed_launches": 0, "pending_launches": 1, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 558, "name": "Himawari-9", "description": "Himawari-9 is a geostationary weather satellite operated by the Japan Meteorological Agency. It will be placed at 140 degrees East and will replace Himawari-8 in 2022. The satellite is about 3,500 kilograms and has a design life of around 15 years with operational life lasting 8 years.The main instrument aboard is a 16 channel multispectral imager to capture visible light and infrared images of the Asian-Pacific region.", "launch_designator": null, "type": "Earth Science", "orbit": { "id": 2, "name": "Geostationary Transfer Orbit", "abbrev": "GTO" }, "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": 94, "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": 56, "orbital_launch_attempt_count": 56 }, "infoURLs": [], "vidURLs": [ { "priority": 0, "source": null, "publisher": null, "title": "静止気象衛星「ひまわり9号」/H-IIAロケット31号機 打ち上げライブ中継 ｜The live broadcast of the Himawari-9/H-IIA F31 launch", "description": "H-IIAロケット31号機による「ひまわり9号」打ち上げの様子をライブ中継しました。 The live broadcast of the Himawari-9/H-IIA F31 launch 中継時間：打ち上げ～衛星分離まで約80分 ライブ中継 MC紹介 三菱重工業株式会社 防衛・宇宙ドメイン 宇宙事業部 宇宙...", "feature_image": "https://i.ytimg.com/vi/U9KkDsi4u8k/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=U9KkDsi4u8k", "type": null, "language": null, "start_time": null, "end_time": null } ], "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": 5595, "location_launch_attempt_count": 67, "pad_launch_attempt_count": 38, "agency_launch_attempt_count": 29, "orbital_launch_attempt_count_year": 66, "location_launch_attempt_count_year": 2, "pad_launch_attempt_count_year": 2, "agency_launch_attempt_count_year": 2, "pad_turnaround": "P258DT21H35M", "mission_patches": [], "type": "detailed" }
