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/3b901da4-e396-437e-aa16-63593c4dec40/?format=api
{ "id": "3b901da4-e396-437e-aa16-63593c4dec40", "url": "https://ll.thespacedevs.com/2.2.0/launch/3b901da4-e396-437e-aa16-63593c4dec40/?format=api", "slug": "h-iib-304-kounotori-8-htv-8", "flightclub_url": null, "r_spacex_api_id": null, "name": "H-IIB 304 | Kounotori 8 (HTV-8)", "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:44Z", "updates": [], "net": "2019-09-24T16:05:05Z", "net_precision": null, "window_end": "2019-09-24T16:05:05Z", "window_start": "2019-09-24T16:05:05Z", "probability": -1, "weather_concerns": null, "holdreason": "", "failreason": "", "hashtag": "#HTV8", "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": 50, "consecutive_successful_launches": 2, "successful_launches": 49, "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://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/mitsubishi2520heavy2520industries_logo_20200117065724.png", "image_url": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/mitsubishi2520heavy2520industries_image_20200117065724.jpg", "nation_url": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/mitsubishi2520heavy2520industries_nation_20240112111043.jpg" }, "rocket": { "id": 2216, "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": 50, "consecutive_successful_launches": 2, "successful_launches": 49, "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://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/mitsubishi2520heavy2520industries_logo_20200117065724.png", "image_url": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/mitsubishi2520heavy2520industries_image_20200117065724.jpg", "nation_url": "https://spacelaunchnow-prod-east.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://spacelaunchnow-prod-east.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": 490, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/flight/490/?format=api", "mission_end": "2019-11-01T17:21:00Z", "destination": "International Space Station", "launch_crew": [], "onboard_crew": [], "landing_crew": [], "spacecraft": { "id": 430, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/430/?format=api", "name": "Kounotori 8", "serial_number": "HTV-8", "is_placeholder": false, "in_space": false, "time_in_space": "P38DT1H15M55S", "time_docked": "P34DT6H9M", "flights_count": 1, "mission_ends_count": 1, "status": { "id": 4, "name": "Single Use" }, "description": "Kounotori 8 is the eighth HTV spacecraft. It is scheduled to launch in September 2019 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://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/japan2520aerospace2520exploration2520agency_image_20190207032440.jpeg", "logo_url": "https://spacelaunchnow-prod-east.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://spacelaunchnow-prod-east.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": 478, "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": 227, "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://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/international2520space2520station_image_20190220215716.jpeg" }, "docking": "2019-09-28T11:12:00Z", "departure": "2019-11-01T17:21: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": 1032, "name": "Kounotori 8 (HTV-8)", "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": null, "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": "", "map_image": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/launch_images/location_26_20200803142507.jpg", "timezone_name": "Asia/Tokyo", "total_launch_count": 90, "total_landing_count": 0 }, "country_code": "JPN", "map_image": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/launch_images/pad_yoshinobu_launch_complex_lp-2_20230707124715.jpg", "total_launch_count": 11, "orbital_launch_attempt_count": 11 }, "infoURLs": [], "vidURLs": [ { "priority": 0, "source": null, "publisher": null, "title": "【現地中継】H-IIBロケット8号機 こうのとり８号【再】打上げ / H-2B Rocket F8 HTV-8 reLaunch", "description": "2019年9月24日 午前1時30分頃に予定されている H-2Bロケット8号機打上げの様子を 現地種子島から中継します。 ※放送開始時刻を変更する場合があります。 打上げ予定日(Launch Date）：2019/9/24 打上げ予定時刻(Launch Time)：1:30頃 Around 1:30 +0900 ...", "feature_image": "https://i.ytimg.com/vi/9_5s7nf2SMI/hqdefault.jpg", "url": "https://www.youtube.com/watch?v=9_5s7nf2SMI", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 0, "source": null, "publisher": null, "title": "NASA Live: Official Stream of NASA TV", "description": "Direct from America's space program to YouTube, watch NASA TV live streaming here to get the latest from our exploration of the universe and learn how we dis...", "feature_image": "https://i.ytimg.com/vi/21X5lGlDOfg/maxresdefault_live.jpg", "url": "https://www.youtube.com/watch?v=21X5lGlDOfg", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 0, "source": null, "publisher": null, "title": "YouTube", "description": "If the owner of this video has granted you access, please sign in.", "feature_image": null, "url": "https://www.youtube.com/watch?v=EqGcvxZRIzI", "type": null, "language": null, "start_time": null, "end_time": null } ], "webcast_live": false, "timeline": [], "image": "https://spacelaunchnow-prod-east.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://spacelaunchnow-prod-east.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": 5877, "location_launch_attempt_count": 79, "pad_launch_attempt_count": 8, "agency_launch_attempt_count": 40, "orbital_launch_attempt_count_year": 67, "location_launch_attempt_count_year": 1, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 1, "pad_turnaround": "P366DT22H12M38S", "mission_patches": [], "type": "detailed" }
