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/fab58052-1fee-4020-9ef0-6b345fe878d8/?format=api
{ "id": "fab58052-1fee-4020-9ef0-6b345fe878d8", "url": "https://ll.thespacedevs.com/2.2.0/launch/fab58052-1fee-4020-9ef0-6b345fe878d8/?format=api", "slug": "h-iib-304-kounotori-2-htv-2", "flightclub_url": null, "r_spacex_api_id": null, "name": "H-IIB 304 | Kounotori 2 (HTV-2)", "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:50:04Z", "updates": [], "net": "2011-01-22T05:37:57Z", "net_precision": null, "window_end": "2011-01-22T05:37:57Z", "window_start": "2011-01-22T05:37:57Z", "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": 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": 1508, "configuration": { "id": 77, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/77/?format=api", "name": "H-IIB", "active": false, "reusable": false, "description": "H-IIB (H2B) is an expendable launch system used to launch H-II Transfer Vehicles (HTV, or Kounotori) towards the International Space Station. H-IIB rockets are liquid-fuelled with solid-fuel strap-on boosters and are launched from the Tanegashima Space Center in Japan. Mitsubishi and JAXA have been primarily responsible for design, manufacture, and operation of H-IIB.", "family": "H-II", "full_name": "H-IIB 304", "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": "304", "alias": "", "min_stage": 0, "max_stage": 2, "length": 56.6, "diameter": 5.2, "maiden_flight": "2009-09-10", "launch_cost": "112500000", "launch_mass": 551, "leo_capacity": 16500, "gto_capacity": 8000, "to_thrust": 9000, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/h-iib_304_lifto_image_20240325125154.jpg", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/H-IIB", "total_launch_count": 9, "consecutive_successful_launches": 9, "successful_launches": 9, "failed_launches": 0, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": { "id": 266, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/flight/266/?format=api", "mission_end": "2011-03-30T03:09:00Z", "destination": "International Space Station", "launch_crew": [], "onboard_crew": [], "landing_crew": [], "spacecraft": { "id": 172, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/172/?format=api", "name": "Kounotori 2", "serial_number": "HTV-2", "is_placeholder": false, "in_space": false, "time_in_space": "P66DT21H31M3S", "time_docked": "P60D", "flights_count": 1, "mission_ends_count": 1, "status": { "id": 4, "name": "Single Use" }, "description": "Kounotori 2 , also known as HTV-2, was launched in January 2011 and was the second Japanese H-II Transfer Vehicle to resupply the International Space Station (ISS). It was launched by the H-IIB Launch Vehicle No. 2 (H-IIB F2) manufactured by MHI and JAXA. After the supplies were unloaded, Kounotori 2 was loaded with waste material from ISS, including used experiment equipment and used clothes. Kounotori 2 was then unberthed and separated from the ISS and burned up upon reentering the atmosphere on 30 March 2011.", "spacecraft_config": { "id": 18, "url": "https://ll.thespacedevs.com/2.2.0/config/spacecraft/18/?format=api", "name": "H-II Transfer Vehicle (HTV)", "type": { "id": 4, "name": "Cargo Resupply" }, "agency": { "id": 37, "url": "https://ll.thespacedevs.com/2.2.0/agencies/37/?format=api", "name": "Japan Aerospace Exploration Agency", "featured": true, "type": "Government", "country_code": "JPN", "abbrev": "JAXA", "description": "The Japan Aerospace Exploration Agency (JAXA) is Japan's national aero-space agency. Through the merger of three previously independent organizations, JAXA was formed on 1 October 2003. JAXA is responsible for research, technology development and the launch of satellites into orbit, and is involved in many more advanced missions, such as asteroid exploration and possible manned exploration of the Moon. JAXA launch their Epsilon vehicle from the Uchinoura Space Center and their H-II vehicles from the Tanegashima Space Center.", "administrator": "Administrator: Hiroshi Yamakawa", "founding_year": "2003", "launchers": "H-II", "spacecraft": "", "parent": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/japan2520aerospace2520exploration2520agency_image_20190207032440.jpeg", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/japan2520aerospace2520exploration2520agency_logo_20190207032440.png" }, "in_use": false, "capability": "Cargo Earth Orbit Logistics", "history": "Like the European Automated Transfer Vehicle the Japan Aerospace Exploration Agency had agreed to take part in the resupply operations of the international space station and developed the HTV to perform this task.", "details": "The HTV is about 9.8 metres (32 ft) long (including maneuvering thrusters at one end) and 4.4 metres (14 ft) in diameter. Total mass when empty is 10.5 tonnes (11.6 short tons), with a maximum total payload of 6,000 kilograms (13,000 lb; 6.0 t; 6.6 short tons), for a maximum launch weight of 16.5 tonnes (18.2 short tons). The HTV is comparable in function to the Russian Progress, European ATV, commercial Dragon, and commercial Cygnus spacecraft, all of which bring supplies to the ISS. Like the ATV, the HTV carries more than twice the payload of the Progress, but is launched less than half as often. Unlike Progress capsules and ATVs, which use the docking ports automatically, HTVs and American commercial spacecraft approach the ISS in stages, and once they reach their closest parking orbit to the ISS, crew grapple them using the robotic arm Canadarm2 and berth them to an open berthing port on the Harmony module.", "maiden_flight": "2009-09-10", "height": 9.8, "diameter": 4.4, "human_rated": false, "crew_capacity": null, "payload_capacity": 6000, "payload_return_capacity": 20, "flight_life": "Solo flight about 100 hours, stand-by more than a week, docked with the ISS about 30 days.", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/htv-4_captured__image_20240325122159.jpeg", "nation_url": null, "wiki_link": "https://en.wikipedia.org/wiki/H-II_Transfer_Vehicle", "info_link": "" } }, "landing": { "id": 472, "attempt": false, "success": null, "description": "The Kounotori spacecraft burned up as planned upon entering Earth's atmosphere.", "downrange_distance": null, "location": null, "type": { "id": 7, "name": "Destructive Reentry", "abbrev": "ATM", "description": "Spacecraft burned up in the atmosphere" } }, "docking_events": [ { "id": 144, "spacestation": { "id": 4, "url": "https://ll.thespacedevs.com/2.2.0/spacestation/4/?format=api", "name": "International Space Station", "status": { "id": 1, "name": "Active" }, "founded": "1998-11-20", "description": "The International Space Station (ISS) is a space station, or a habitable artificial satellite, in low Earth orbit. Its first component was launched into orbit in 1998, with the first long-term residents arriving in November 2000. It has been inhabited continuously since that date. The last pressurised module was fitted in 2011, and an experimental inflatable space habitat was added in 2016. The station is expected to operate until 2030. Development and assembly of the station continues, with several new elements scheduled for launch in 2019. The ISS is the largest human-made body in low Earth orbit and can often be seen with the naked eye from Earth. The ISS consists of pressurised habitation modules, structural trusses, solar arrays, radiators, docking ports, experiment bays and robotic arms. ISS components have been launched by Russian Proton and Soyuz rockets, and American Space Shuttles.", "orbit": "Low Earth Orbit", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/international2520space2520station_image_20190220215716.jpeg" }, "docking": "2011-01-27T00:00:00Z", "departure": "2011-03-28T00:00:00Z", "docking_location": { "id": 21, "name": "Harmony nadir", "spacestation": { "id": 4, "url": "https://ll.thespacedevs.com/2.2.0/spacestation/4/?format=api", "name": "International Space Station" } } } ] } }, "mission": { "id": 225, "name": "Kounotori 2 (HTV-2)", "description": "Uncrewed cargo resupply mission to International Space Station.", "launch_designator": null, "type": "Resupply", "orbit": { "id": 8, "name": "Low Earth Orbit", "abbrev": "LEO" }, "agencies": [], "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": 0, "source": null, "publisher": null, "title": "こうのとり2号機/H-IIB2号機クイックレビュー／KOUNOTORI2/H-IIB F2 Quick Review", "description": "宇宙ステーション補給機「こうのとり」2号機（HTV2）を搭載したH-IIBロケット2号機を2011年1月22日に種子島宇宙センターから打ち上げました。こうのとり2号機は1月28日に国際宇宙ステーション（ISS）に結合しました。 JAXA launched the H-IIB Launch Vehicle Flig...", "feature_image": "https://i.ytimg.com/vi/H1E8oynAsC4/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=H1E8oynAsC4", "type": null, "language": null, "start_time": null, "end_time": null } ], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/h-iib_304_lifto_image_20240325125154.jpg", "infographic": null, "program": [ { "id": 17, "url": "https://ll.thespacedevs.com/2.2.0/program/17/?format=api", "name": "International Space Station", "description": "The International Space Station programme is tied together by a complex set of legal, political and financial agreements between the sixteen nations involved in the project, governing ownership of the various components, rights to crewing and utilization, and responsibilities for crew rotation and resupply of the International Space Station. It was conceived in 1984 by President Ronald Reagan, during the Space Station Freedom project as it was originally called.", "agencies": [ { "id": 16, "url": "https://ll.thespacedevs.com/2.2.0/agencies/16/?format=api", "name": "Canadian Space Agency", "type": "Government" }, { "id": 27, "url": "https://ll.thespacedevs.com/2.2.0/agencies/27/?format=api", "name": "European Space Agency", "type": "Multinational" }, { "id": 37, "url": "https://ll.thespacedevs.com/2.2.0/agencies/37/?format=api", "name": "Japan Aerospace Exploration Agency", "type": "Government" }, { "id": 44, "url": "https://ll.thespacedevs.com/2.2.0/agencies/44/?format=api", "name": "National Aeronautics and Space Administration", "type": "Government" }, { "id": 63, "url": "https://ll.thespacedevs.com/2.2.0/agencies/63/?format=api", "name": "Russian Federal Space Agency (ROSCOSMOS)", "type": "Government" } ], "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/international2_program_20201129184745.png", "start_date": "1998-11-20T06:40:00Z", "end_date": null, "info_url": "https://www.nasa.gov/mission_pages/station/main/index.html", "wiki_url": "https://en.wikipedia.org/wiki/International_Space_Station_programme", "mission_patches": [], "type": { "id": 2, "name": "Human Spaceflight" } } ], "orbital_launch_attempt_count": 5109, "location_launch_attempt_count": 51, "pad_launch_attempt_count": 2, "agency_launch_attempt_count": 13, "orbital_launch_attempt_count_year": 3, "location_launch_attempt_count_year": 1, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 1, "pad_turnaround": "P498DT12H36M11S", "mission_patches": [], "type": "detailed" }
