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/0680d9c6-8b90-405e-bbe0-167cd48e36bb/?format=api
{ "id": "0680d9c6-8b90-405e-bbe0-167cd48e36bb", "url": "https://ll.thespacedevs.com/2.2.0/launch/0680d9c6-8b90-405e-bbe0-167cd48e36bb/?format=api", "slug": "h3-22-michibiki-6-qzs-6", "flightclub_url": null, "r_spacex_api_id": null, "name": "H3-22 | Michibiki 6 (QZS-6)", "status": { "id": 3, "name": "Launch Successful", "abbrev": "Success", "description": "The launch vehicle successfully inserted its payload(s) into the target orbit(s)." }, "last_updated": "2025-02-09T22:18:20Z", "updates": [ { "id": 9982, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Launch success.", "info_url": "https://www.jaxa.jp/press/2025/02/20250202-1_j.html", "created_by": "Cosmic_Penguin", "created_on": "2025-02-02T11:38:00Z" }, { "id": 9980, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Spacecraft separation.", "info_url": "https://www.youtube.com/watch?v=uZkj9FkYMyQ", "created_by": "Cosmic_Penguin", "created_on": "2025-02-02T09:00:00Z" }, { "id": 9979, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Liftoff.", "info_url": "https://www.youtube.com/watch?v=uZkj9FkYMyQ", "created_by": "Cosmic_Penguin", "created_on": "2025-02-02T08:30:00Z" }, { "id": 9978, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/ll2_profile_20230311134739.png", "comment": "Official Webcast by JAXA | 宇宙航空研究開発機構 has started", "info_url": "https://www.youtube.com/watch?v=uZkj9FkYMyQ", "created_by": "LL2", "created_on": "2025-02-02T08:05:00Z" }, { "id": 9954, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Delayed to February 2 due to launch site weather.", "info_url": "https://www.jaxa.jp/press/2025/01/20250130-1_j.html", "created_by": "Cosmic_Penguin", "created_on": "2025-01-30T05:21:00Z" }, { "id": 9472, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "GO for launch.", "info_url": "https://www.jaxa.jp/press/2024/12/20241211-1_j.html", "created_by": "Cosmic_Penguin", "created_on": "2024-12-11T05:19:00Z" }, { "id": 9351, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Launch planned NLT Q1 2025.", "info_url": "https://x.com/clearusui/status/1861682138288136421", "created_by": "Cosmic_Penguin", "created_on": "2024-11-27T10:51:00Z" }, { "id": 5883, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET 2025.", "info_url": "https://www8.cao.go.jp/space/comittee/dai108/siryou2_2.pdf", "created_by": "Cosmic_Penguin", "created_on": "2023-12-06T11:08:12Z" } ], "net": "2025-02-02T08:30:00Z", "net_precision": { "id": 0, "name": "Second", "abbrev": "SEC", "description": "The T-0 is accurate to the second." }, "window_end": "2025-02-02T10:30:00Z", "window_start": "2025-02-02T08:30: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": 7767, "configuration": { "id": 486, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/486/?format=api", "name": "H3-22", "active": true, "reusable": false, "description": "The H3 Launch Vehicle is a Japanese expendable launch system.\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-22", "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": "22", "alias": "", "min_stage": 2, "max_stage": 2, "length": 63.0, "diameter": 5.27, "maiden_flight": "2023-03-07", "launch_cost": "50000000", "launch_mass": null, "leo_capacity": null, "gto_capacity": 5400, "to_thrust": 7542, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/h3-22_image_20230307130808.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": 5, "consecutive_successful_launches": 4, "successful_launches": 4, "failed_launches": 1, "pending_launches": 3, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 6285, "name": "Michibiki 6 (QZS-6)", "description": "QZSS (Quasi Zenith Satellite System) is a Japanese satellite navigation system operating from inclined, elliptical geosynchronous orbits to achieve optimal high-elevation visibility in urban canyons and mountainous areas. The navigation system objective is to broadcast GPS-interoperable and augmentation signals as well as original Japanese (QZSS) signals from a three-spacecraft constellation.\r\n\r\nThe navigation system objective is to broadcast GPS-interoperable and augmentation signals as well as original Japanese (QZSS) signals from a three-spacecraft constellation in inclined, elliptical geosynchronous orbits.", "launch_designator": null, "type": "Navigation", "orbit": { "id": 2, "name": "Geostationary Transfer Orbit", "abbrev": "GTO" }, "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": 10, "source": "youtube.com", "publisher": "JAXA | 宇宙航空研究開発機構", "title": "「みちびき6号機」（準天頂衛星）／H3ロケット5号機打上げライブ中継", "description": "「みちびき6号機」（準天頂衛星）を搭載したH3ロケット5号機の打上げの様子を、種子島宇宙センターよりライブ配信します。\nThe live coverage of the launch of the 5th H3 Launch Vehicle (H3 F5: Flight No.5) with MICHIBIKI No. 6, Quasi-Zenith Satellite System (QZS-6...", "feature_image": "https://i.ytimg.com/vi/uZkj9FkYMyQ/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=uZkj9FkYMyQ", "type": { "id": 1, "name": "Official Webcast" }, "language": { "id": 6, "name": "Japanese", "code": "jp" }, "start_time": "2025-02-02T07:40:16Z", "end_time": "2025-02-02T09:12:35Z" } ], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/h3-22_image_20230307130808.jpeg", "infographic": null, "program": [], "orbital_launch_attempt_count": 6872, "location_launch_attempt_count": 94, "pad_launch_attempt_count": 14, "agency_launch_attempt_count": 54, "orbital_launch_attempt_count_year": 23, "location_launch_attempt_count_year": 1, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 1, "pad_turnaround": "P90DT1H42M", "mission_patches": [ { "id": 1095, "name": "QZS-5 to 7 Patch", "priority": 10, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/mission_patch_images/qzs-252052520_mission_patch_20250203070402.png", "agency": { "id": 37, "url": "https://ll.thespacedevs.com/2.2.0/agencies/37/?format=api", "name": "Japan Aerospace Exploration Agency", "type": "Government" } } ], "type": "detailed" }
