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/3a4dc969-d264-48a1-b113-bf69a798a5c4/?format=api
{ "id": "3a4dc969-d264-48a1-b113-bf69a798a5c4", "url": "https://ll.thespacedevs.com/2.2.0/launch/3a4dc969-d264-48a1-b113-bf69a798a5c4/?format=api", "slug": "h3-24-lunar-polar-exploration-mission-lupex", "flightclub_url": null, "r_spacex_api_id": null, "name": "H3-24 | Lunar Polar Exploration Mission (LUPEX)", "status": { "id": 2, "name": "To Be Determined", "abbrev": "TBD", "description": "Current date is a placeholder or rough estimation based on unreliable or interpreted sources." }, "last_updated": "2024-12-10T14:10:53Z", "updates": [ { "id": 9468, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Reverted to NET 2026 per Japanese government documentation, awaiting clarification.", "info_url": "https://www8.cao.go.jp/space/comittee/dai115/siryou2-3.pdf", "created_by": "Cosmic_Penguin", "created_on": "2024-12-10T14:10:00Z" }, { "id": 8926, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET 2028.", "info_url": "https://x.com/aj_fi/status/1846950470524297310", "created_by": "Cosmic_Penguin", "created_on": "2024-10-18T01:42:00Z" }, { "id": 5887, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET late 2025.", "info_url": "https://www8.cao.go.jp/space/comittee/dai108/siryou2_2.pdf", "created_by": "Cosmic_Penguin", "created_on": "2023-12-06T11:10:50Z" } ], "net": "2026-12-31T00:00:00Z", "net_precision": { "id": 14, "name": "Year", "abbrev": "Y", "description": "The T-0 is expected in the given year." }, "window_end": "2026-12-31T00:00:00Z", "window_start": "2026-12-31T00:00:00Z", "probability": null, "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": 7770, "configuration": { "id": 204, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/204/?format=api", "name": "H3-24", "active": true, "reusable": false, "description": "The H3 Launch Vehicle is an expendable launch system in development in Japan.\r\nEach H3 booster configuration has a two-digit and a letter designation that indicates the features of that configuration. The first digit represents the number of LE-9 engines on the main stage, either \"2\" or \"3\". The second digit indicates the number of SRB-3 solid rocket boosters attached to the base of the rocket, and can be \"0\", \"2\" or \"4\". All layouts of solid boosters are symmetrical. The letter in the end shows the length of the payload fairing, either short \"S\" or long \"L\". For example, an H3-24L has two engines, four solid rocket boosters, and a long fairing, whereas an H3-30S has three engines, no solid rocket boosters, and a short fairing.", "family": "H3", "full_name": "H3-24", "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": "24", "alias": "", "min_stage": 2, "max_stage": 2, "length": 63.0, "diameter": 5.27, "maiden_flight": null, "launch_cost": "50000000", "launch_mass": null, "leo_capacity": null, "gto_capacity": 7900, "to_thrust": 12142, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/h-iii_image_20221104084531.jpeg", "info_url": "http://global.jaxa.jp/press/2015/07/20150702_h3.html", "wiki_url": "https://en.wikipedia.org/wiki/H3_(rocket)", "total_launch_count": 0, "consecutive_successful_launches": 0, "successful_launches": 0, "failed_launches": 0, "pending_launches": 5, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 6288, "name": "Lunar Polar Exploration Mission (LUPEX)", "description": "The Lunar Polar Exploration mission (LUPEX) is a robotic lunar mission jointly developed by the Indian Space Research Organisation (ISRO) and Japan Aerospace Exploration Agency (JAXA), deploying a lunar rover and lander to explore the south pole region of the Moon.\r\n\r\nJAXA will provide the under-development H3 launch vehicle and the rover, while ISRO would be responsible for the lander.", "launch_designator": null, "type": "Lunar Exploration", "orbit": { "id": 11, "name": "Lunar Orbit", "abbrev": "LO" }, "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": [], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/h-iii_image_20221104084531.jpeg", "infographic": null, "program": [], "orbital_launch_attempt_count": 7203, "location_launch_attempt_count": 105, "pad_launch_attempt_count": 24, "agency_launch_attempt_count": 64, "orbital_launch_attempt_count_year": 88, "location_launch_attempt_count_year": 5, "pad_launch_attempt_count_year": 5, "agency_launch_attempt_count_year": 5, "pad_turnaround": "P365D", "mission_patches": [], "type": "detailed" }
