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/0d178574-7b2c-456b-97f8-bbb5532248ad/?format=api
{ "id": "0d178574-7b2c-456b-97f8-bbb5532248ad", "url": "https://ll.thespacedevs.com/2.2.0/launch/0d178574-7b2c-456b-97f8-bbb5532248ad/?format=api", "slug": "h-iib-304-kounotori-9-htv-9", "flightclub_url": null, "r_spacex_api_id": null, "name": "H-IIB 304 | Kounotori 9 (HTV-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-07-07T12:51:58Z", "updates": [], "net": "2020-05-20T17:31:00Z", "net_precision": null, "window_end": "2020-05-20T17:31:00Z", "window_start": "2020-05-20T17:31:00Z", "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": 2524, "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": 572, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/flight/572/?format=api", "mission_end": "2020-08-20T07:07:00Z", "destination": "International Space Station", "launch_crew": [], "onboard_crew": [], "landing_crew": [], "spacecraft": { "id": 440, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/440/?format=api", "name": "Kounotori 9", "serial_number": "HTV-9", "is_placeholder": false, "in_space": false, "time_in_space": "P91DT13H36M", "time_docked": "P85DT5H23M", "flights_count": 1, "mission_ends_count": 1, "status": { "id": 4, "name": "Single Use" }, "description": "Kounotori 9 is the ninth HTV spacecraft. It is scheduled to launch in May 2020 on a resupply mission to the ISS.", "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": 479, "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": 235, "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": "2020-05-25T12:13:00Z", "departure": "2020-08-18T17:36: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": 1037, "name": "Kounotori 9 (HTV-9)", "description": "The last H-II Transfer Vehicle \"Kounotori\" will be launched on an H-IIB 304 launch vehicle, carrying 6,200 kg (13,669 lbs) of supplies and science experiments to be conducted by astronauts aboard the International Space Station. Kounotori 9 will be the last original HTV spacecaft : its successor scheduled to launch in February 2022 will be the first of the new HTV-X version.", "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": "【録画】「こうのとり」9号機/H-IIBロケット9号機打上げライブ中継", "description": "5/21（木）宇宙ステーション補給機「こうのとり」9号機（HTV9）HｰⅡBロケット9号機打上げライブ中継です。 一部のデバイスで音声に不具合があったため、新しいアドレスにて録画を公開いたします。 打上げ日時：2020年5月21日2時31分00秒（日本標準時） 「こうのとり」9号機紹介サイト https://is...", "feature_image": "https://i.ytimg.com/vi/-33Bl6fXSCE/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=-33Bl6fXSCE", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 0, "source": null, "publisher": null, "title": "HTV-9 launch", "description": "JAXA’s H-IIB Launch Vehicle No. 9 (H-IIB F9, ロケット9) launched the H-II Transfer Vehicle “KOUNOTORI9” (HTV-9, こうのとり9) from the Yoshinobu Launch Complex, at JAX...", "feature_image": "https://i.ytimg.com/vi/Mji_UmW-uiE/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=Mji_UmW-uiE", "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": 5955, "location_launch_attempt_count": 81, "pad_launch_attempt_count": 9, "agency_launch_attempt_count": 42, "orbital_launch_attempt_count_year": 33, "location_launch_attempt_count_year": 2, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 2, "pad_turnaround": "P239DT1H25M55S", "mission_patches": [], "type": "detailed" }
