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/2ba0b63c-e5f6-4899-b588-387c7c8e71ca/?format=api
{ "id": "2ba0b63c-e5f6-4899-b588-387c7c8e71ca", "url": "https://ll.thespacedevs.com/2.2.0/launch/2ba0b63c-e5f6-4899-b588-387c7c8e71ca/?format=api", "slug": "h-iia-202-xrism-slim", "flightclub_url": null, "r_spacex_api_id": null, "name": "H-IIA 202 | XRISM & SLIM", "status": { "id": 3, "name": "Launch Successful", "abbrev": "Success", "description": "The launch vehicle successfully inserted its payload(s) into the target orbit(s)." }, "last_updated": "2024-03-17T18:27:34Z", "updates": [ { "id": 5088, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Launch success.", "info_url": "https://www.youtube.com/watch?v=2r17DKvoiv8", "created_by": "Cosmic_Penguin", "created_on": "2023-09-07T03:13:40Z" }, { "id": 5087, "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=Ej4ZMp4a2xw", "created_by": "Cosmic_Penguin", "created_on": "2023-09-06T23:42:40Z" }, { "id": 5086, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/ll2_profile_20230311134739.png", "comment": "Livestream has started", "info_url": "https://www.youtube.com/watch?v=Ej4ZMp4a2xw", "created_by": "LL2", "created_on": "2023-09-06T23:03:42Z" }, { "id": 5072, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "New launch date and time.", "info_url": "https://global.jaxa.jp/press/2023/09/20230904-1_e.html", "created_by": "Cosmic_Penguin", "created_on": "2023-09-04T06:06:51Z" }, { "id": 5021, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "TBD September due to weather", "info_url": null, "created_by": "Nosu", "created_on": "2023-08-30T09:11:17Z" }, { "id": 5012, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/swgustav_profile_20210218062738.jpg", "comment": "Scrub due to upper winds", "info_url": "https://twitter.com/MHI_LS/status/1695949917922144330", "created_by": "SwGustav", "created_on": "2023-08-28T00:13:05Z" }, { "id": 5011, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/ll2_profile_20230311134739.png", "comment": "Livestream has started", "info_url": "https://www.youtube.com/watch?v=3TTTJ20iRbs", "created_by": "LL2", "created_on": "2023-08-27T23:41:51Z" }, { "id": 4987, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "24 hours slip due to weather.", "info_url": "https://twitter.com/mhi_ls/status/1694938925637529879", "created_by": "Cosmic_Penguin", "created_on": "2023-08-25T06:30:41Z" }, { "id": 4978, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "24 hours slip due to weather.", "info_url": "https://x.com/nvslive/status/1694576009570320505", "created_by": "Cosmic_Penguin", "created_on": "2023-08-24T05:09:27Z" }, { "id": 4562, "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/2023/07/20230711-1_j.html", "created_by": "Cosmic_Penguin", "created_on": "2023-07-11T05:05:55Z" }, { "id": 4561, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET Aug. 26", "info_url": "https://twitter.com/mageshiman1025/status/1678603005053255683", "created_by": "Cosmic_Penguin", "created_on": "2023-07-11T04:27:33Z" }, { "id": 3712, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET August 2023", "info_url": "https://www.nikkei.com/article/DGXZQOUC30C8R0Q3A330C2000000/", "created_by": "Cosmic_Penguin", "created_on": "2023-03-31T03:32:24Z" }, { "id": 2477, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Slipped to Fiscal Year 2023 = NET April 2023", "info_url": "https://nordot.app/947022181342822400", "created_by": "Cosmic_Penguin", "created_on": "2022-09-26T09:56:05Z" }, { "id": 2107, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET 2023", "info_url": "https://www.nasa.gov/image-feature/goddard/2022/japanese-nasa-x-ray-observatory-stands-tall-as-testing-begins", "created_by": "Cosmic_Penguin", "created_on": "2022-07-20T01:55:16Z" }, { "id": 3692, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET May 2023", "info_url": "https://licensing.fcc.gov/cgi-bin/ws.exe/prod/ib/forms/reports/swr031b.hts?q_set=V_SITE_ANTENNA_FREQ.file_numberC/File+Number/%3D/SESSTA2023032200392&prepare=&column=V_SITE_ANTENNA_FREQ.file_numberC/F", "created_by": "Cosmic_Penguin", "created_on": "2023-03-28T16:16:30Z" } ], "net": "2023-09-06T23:42:11Z", "net_precision": { "id": 0, "name": "Second", "abbrev": "SEC", "description": "The T-0 is accurate to the second." }, "window_end": "2023-09-06T23:42:11Z", "window_start": "2023-09-06T23:42:11Z", "probability": null, "weather_concerns": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "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": "", "launch_library_url": null, "total_launch_count": 36, "consecutive_successful_launches": 1, "successful_launches": 32, "failed_launches": 4, "pending_launches": 4, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "http://www.jaxa.jp/", "wiki_url": "http://en.wikipedia.org/wiki/Japan_Aerospace_Exploration_Agency", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/japan2520aerospace2520exploration2520agency_logo_20190207032440.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/japan2520aerospace2520exploration2520agency_image_20190207032440.jpeg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/japan2520aerospace2520exploration2520agency_nation_20230531052930.png" }, "rocket": { "id": 175, "configuration": { "id": 32, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/32/?format=api", "name": "H-IIA", "active": true, "reusable": false, "description": "H-IIA (H2A) is an active expendable launch system operated by Mitsubishi Heavy Industries (MHI) for the Japan Aerospace Exploration Agency. The liquid-fueled H-IIA rockets have been used to launch satellites into geostationary orbit, to launch a lunar orbiting spacecraft, and to launch Akatsuki, which studied the planet Venus. Launches occur at the Tanegashima Space Center.", "family": "H-II", "full_name": "H-IIA 202", "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": "202", "alias": "", "min_stage": 2, "max_stage": 2, "length": 53.0, "diameter": 4.0, "maiden_flight": "2001-08-29", "launch_cost": "90000000", "launch_mass": 285, "leo_capacity": 10000, "gto_capacity": 4100, "to_thrust": 2260, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/h-iia_202_lifto_image_20240325123250.jpg", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/H-IIA", "total_launch_count": 34, "consecutive_successful_launches": 34, "successful_launches": 34, "failed_launches": 0, "pending_launches": 1, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 685, "name": "XRISM & SLIM", "description": "X-Ray Imaging and Spectroscopy Mission (XRISM), formerly the X-Ray Astronomy Recovery Mission (XARM), is a replacement for the Hitomi satellite that malfunctioned few weeks after the launch. \r\n\r\nSmart Lander for Investigating Moon (SLIM) is a lunar probe that will target a landing on a small crater in Mare Nectaris, an area located near the moon's equator on the side facing Earth.", "launch_designator": null, "type": "Astrophysics", "orbit": { "id": 11, "name": "Lunar Orbit", "abbrev": "LO" }, "agencies": [ { "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": "", "launch_library_url": null, "total_launch_count": 36, "consecutive_successful_launches": 1, "successful_launches": 32, "failed_launches": 4, "pending_launches": 4, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "http://www.jaxa.jp/", "wiki_url": "http://en.wikipedia.org/wiki/Japan_Aerospace_Exploration_Agency", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/japan2520aerospace2520exploration2520agency_logo_20190207032440.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/japan2520aerospace2520exploration2520agency_image_20190207032440.jpeg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/japan2520aerospace2520exploration2520agency_nation_20230531052930.png" } ], "info_urls": [], "vid_urls": [] }, "pad": { "id": 41, "url": "https://ll.thespacedevs.com/2.2.0/pad/41/?format=api", "agency_id": 37, "name": "Yoshinobu Launch Complex LP-1", "description": "", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Yoshinobu_Launch_Complex", "map_url": "https://www.google.com/maps?q=30.400813,130.977748", "latitude": "30.400813", "longitude": "130.977748", "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_41_20200803143551.jpg", "total_launch_count": 56, "orbital_launch_attempt_count": 56 }, "infoURLs": [], "vidURLs": [ { "priority": 7, "source": "www.youtube.com", "publisher": null, "title": "XRISM/SLIM Launch Live Streaming", "description": "日本語 ⇒ https://www.youtube.com/watch?v=RV59wONfrHUThe live coverage of the launch of XRISM/SLIM.Broadcast schedule: 8:10 a.m. on September 7, 2023 (JST)Launc...", "feature_image": "https://i.ytimg.com/vi/Ej4ZMp4a2xw/maxresdefault_live.jpg", "url": "https://www.youtube.com/watch?v=Ej4ZMp4a2xw", "type": { "id": 1, "name": "Official Webcast" }, "language": { "id": 1, "name": "English", "code": "en" }, "start_time": null, "end_time": null }, { "priority": 8, "source": "www.youtube.com", "publisher": null, "title": "X線分光撮像衛星XRISM／小型月着陸実証機SLIM 打上げライブ中継", "description": "English ⇒ https://www.youtube.com/watch?v=Ej4ZMp4a2xwX線分光撮像衛星XRISM／小型月着陸実証機SLIM打上げの様子です。放送予定：2023年9月7日(木)8:10頃～打上げ時間：午前8時42分11秒(日本標準時)", "feature_image": "https://i.ytimg.com/vi/RV59wONfrHU/maxresdefault_live.jpg", "url": "https://www.youtube.com/watch?v=RV59wONfrHU", "type": { "id": 1, "name": "Official Webcast" }, "language": { "id": 1, "name": "English", "code": "en" }, "start_time": null, "end_time": null }, { "priority": 9, "source": "www.youtube.com", "publisher": null, "title": "XRISM/SLIM Launch Live Streaming", "description": "日本語 ⇒ https://youtube.com/live/voYZcThSWFEThe live coverage of the launch of XRISM/SLIM.Broadcast schedule: 8:55 a.m. on August 28, 2023 (JST)Launch time: 9...", "feature_image": "https://i.ytimg.com/vi/3TTTJ20iRbs/maxresdefault_live.jpg", "url": "https://www.youtube.com/watch?v=3TTTJ20iRbs", "type": { "id": 1, "name": "Official Webcast" }, "language": { "id": 1, "name": "English", "code": "en" }, "start_time": null, "end_time": null }, { "priority": 10, "source": "www.youtube.com", "publisher": null, "title": "X線分光撮像衛星XRISM／小型月着陸実証機SLIM 打上げライブ中継", "description": "English ⇒ https://youtube.com/live/3TTTJ20iRbsX線分光撮像衛星XRISM／小型月着陸実証機SLIM打上げの様子です。放送予定：2023年8月28日(月)8:55～打上げ時間：午前9時26分22秒(日本標準時)", "feature_image": "https://i.ytimg.com/vi/voYZcThSWFE/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=voYZcThSWFE", "type": { "id": 1, "name": "Official Webcast" }, "language": { "id": 6, "name": "Japanese", "code": "jp" }, "start_time": null, "end_time": null }, { "priority": 11, "source": "www.youtube.com", "publisher": null, "title": "H-IIAロケット47号機 X線分光撮像衛星（XRISM）小型月着陸実証機（SLIM）打上げ H-2A Rocket F47 XRISM & SLIM Launch Live Streaming", "description": "打上げ予定日（Launch Date）：2023.08.27打上げ予定時刻（Launch Time）： 9:30'15\" +0900 (JST)予備期間（Preliminary duration）： 2023.08.28～2023.09.15ペイロード衛星（Payload）： X線分光撮像衛星（XRISM）小型月...", "feature_image": "https://i.ytimg.com/vi/CM_RNsrzsYk/maxresdefault_live.jpg", "url": "https://www.youtube.com/watch?v=CM_RNsrzsYk", "type": { "id": 3, "name": "Unofficial Webcast" }, "language": { "id": 6, "name": "Japanese", "code": "jp" }, "start_time": null, "end_time": null } ], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/h-iia_202_lifto_image_20240325123250.jpg", "infographic": null, "program": [], "orbital_launch_attempt_count": 6512, "location_launch_attempt_count": 88, "pad_launch_attempt_count": 54, "agency_launch_attempt_count": 36, "orbital_launch_attempt_count_year": 144, "location_launch_attempt_count_year": 3, "pad_launch_attempt_count_year": 2, "agency_launch_attempt_count_year": 1, "pad_turnaround": "P223DT21H51M50S", "mission_patches": [], "type": "detailed" }
