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/71514e1b-5411-40b9-a0bf-a711f7e335d8/?format=api
{ "id": "71514e1b-5411-40b9-a0bf-a711f7e335d8", "url": "https://ll.thespacedevs.com/2.2.0/launch/71514e1b-5411-40b9-a0bf-a711f7e335d8/?format=api", "slug": "h3-22-vep-4-ce-sat-1e-tirsat", "flightclub_url": null, "r_spacex_api_id": null, "name": "H3-22 | VEP 4, CE-SAT-1E & TIRSAT", "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-25T12:17:13Z", "updates": [ { "id": 6698, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Launch success, all payloads separated into planned orbits.", "info_url": "https://www.jaxa.jp/press/2024/02/20240217-1_j.html", "created_by": "Cosmic_Penguin", "created_on": "2024-02-17T03:41:13Z" }, { "id": 6695, "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=hEQOlhDRddI", "created_by": "Cosmic_Penguin", "created_on": "2024-02-17T00:23:26Z" }, { "id": 6694, "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=hEQOlhDRddI", "created_by": "LL2", "created_on": "2024-02-16T23:02:56Z" }, { "id": 6659, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Rescheduled for February 17.", "info_url": "https://www.jaxa.jp/press/2024/02/20240214-1_j.html", "created_by": "Cosmic_Penguin", "created_on": "2024-02-14T05:05:36Z" }, { "id": 6647, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Delayed from February 15 due to launch site weather, new launch date TBD.", "info_url": "https://twitter.com/JAXA_jp/status/1757270741853352441", "created_by": "Cosmic_Penguin", "created_on": "2024-02-13T05:36:41Z" }, { "id": 6132, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Added launch window and payload.", "info_url": "https://global.jaxa.jp/press/2023/12/20231228-1_e.html", "created_by": "Cosmic_Penguin", "created_on": "2023-12-28T02:48:17Z" }, { "id": 6121, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET February 15, 2024.", "info_url": "https://twitter.com/nhk_news/status/1740009145406005252", "created_by": "Cosmic_Penguin", "created_on": "2023-12-27T16:51:57Z" }, { "id": 5671, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "No longer scheduled in 2023 (Q1 2024 is inferred from previous reports of launch within Fiscal Year 2023 in Japan).", "info_url": "https://www3.nhk.or.jp/news/html/20231113/k10014256171000.html", "created_by": "Cosmic_Penguin", "created_on": "2023-11-13T03:28:45Z" }, { "id": 5132, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Targeting 2023", "info_url": "https://twitter.com/jeff_foust/status/1701259891254387002", "created_by": "Nosu", "created_on": "2023-09-11T16:05:16Z" }, { "id": 4135, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Added launch per Japanese government decision to de-manifest ALOS-4 from the 2nd launch of H3 and replace it with a new test launch in the -22 configuration.", "info_url": "https://www.mext.go.jp/kaigisiryo/content/20230524-mxt_uchukai01-000029953_4.pdf", "created_by": "Cosmic_Penguin", "created_on": "2023-05-25T04:02:20Z" } ], "net": "2024-02-17T00:22:55Z", "net_precision": { "id": 0, "name": "Second", "abbrev": "SEC", "description": "The T-0 is accurate to the second." }, "window_end": "2024-02-17T04:06:34Z", "window_start": "2024-02-17T00:22:55Z", "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": 7879, "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": 6386, "name": "VEP 4, CE-SAT-1E & TIRSAT", "description": "New test flight of the H3 ordered following the failure of the inaugural launch of H3 in March 2023 with ALOS-3. \r\n\r\nMain payload is VEP 4 (Vehicle Evaluation Payload 4), a 2.6 tonnes mass simulator payload that will be carried on the 2nd test flight of the H3 rocket, instead of the ALOS-4 Earth observation satellite as originally planned. It will be deployed after the 2nd de-orbit burn is completed to test the payload separation mechanism.\r\n\r\n2 hitchhiking secondary payloads have been selected in June 2023:\r\n\r\n* CE-SAT-1E - 70 kilograms class optical Earth observation satellite from Canon Electronics Inc., similar to the previously launched CE-SAT-1.\r\n\r\n* TIRSAT - 3U cubesat by Japan Space Systems and other institutes to test an infrared sensor for Earth surface observation purposes.", "launch_designator": null, "type": "Test Flight", "orbit": { "id": 17, "name": "Sun-Synchronous Orbit", "abbrev": "SSO" }, "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" }, { "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" } ], "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": [ { "priority": 10, "source": "www.rocket.jaxa.jp", "title": "H3ロケット2号機 打上げ特設サイト", "description": "宇宙輸送技術部門は、地球と宇宙を結ぶ輸送手段である「ロケット」を扱う部署です。", "feature_image": null, "url": "https://www.rocket.jaxa.jp/rocket/h3/tf2_special/index.html", "type": { "id": 1, "name": "Official Page" }, "language": { "id": 6, "name": "Japanese", "code": "jp" } } ], "vidURLs": [ { "priority": 10, "source": "youtube.com", "publisher": "JAXA | 宇宙航空研究開発機構", "title": "Launch of the Second H3 Launch Vehicle", "description": "The live coverage of the launch of the Second H3 Launch Vehicle(H3/TF2:Test Flight No.2). Broadcast Start: one hour before the launch on Feb 17 (JST) / on Fe...", "feature_image": "https://i.ytimg.com/vi/hEQOlhDRddI/maxresdefault_live.jpg", "url": "https://www.youtube.com/watch?v=hEQOlhDRddI", "type": { "id": 1, "name": "Official Webcast" }, "language": { "id": 1, "name": "English", "code": "en" }, "start_time": "2024-02-16T23:00:43Z", "end_time": "2024-02-17T00:55:33Z" }, { "priority": 11, "source": "youtube.com", "publisher": "JAXA | 宇宙航空研究開発機構", "title": "H3ロケット試験機2号機打上げライブ中継", "description": "H3ロケット試験機2号機の打上げの様子を種子島宇宙センターよりライブ配信します。配信予定：2024年2月17日打上げ1時間前頃場所：種子島宇宙センター English → https://www.youtube.com/watch?v=hEQOlhDRddI", "feature_image": "https://i.ytimg.com/vi/VtsUTvZRcJM/maxresdefault_live.jpg", "url": "https://www.youtube.com/watch?v=VtsUTvZRcJM", "type": { "id": 1, "name": "Official Webcast" }, "language": { "id": 6, "name": "Japanese", "code": "jp" }, "start_time": "2024-02-14T23:20:00Z", "end_time": null }, { "priority": 12, "source": "youtube.com", "publisher": "NVS", "title": "H３ロケット試験機２号機 打上げライブ配信 H3 Rocket TF2 Launch live Streaming", "description": "打上げ予定日（Launch Date）：2024/2/17打上げ予定時刻（Launch Time）：09:22’55\" +0900 (JST)打上げ可能時間帯（Window）： 09:22’55\"～13:06'34\" +0900 (JST)予備期間（Preliminary duration）： 2024.02.1...", "feature_image": "https://i.ytimg.com/vi/aw2Ilabp2Uc/maxresdefault_live.jpg", "url": "https://www.youtube.com/watch?v=aw2Ilabp2Uc", "type": { "id": 3, "name": "Unofficial Webcast" }, "language": { "id": 1, "name": "English", "code": "en" }, "start_time": "2024-02-16T23:30:00Z", "end_time": null } ], "webcast_live": false, "timeline": [ { "type": { "id": 10, "abbrev": "Liftoff", "description": "First upwards movement of the rocket" }, "relative_time": "P0D" }, { "type": { "id": 77, "abbrev": "SRB Separation", "description": "The solid rocket boosters are separated from the launcher." }, "relative_time": "PT1M56S" }, { "type": { "id": 15, "abbrev": "Fairing Separation", "description": "Separation of the payload fairing" }, "relative_time": "PT3M34S" }, { "type": { "id": 12, "abbrev": "MECO", "description": "Cut-off of the main engine" }, "relative_time": "PT4M58S" }, { "type": { "id": 13, "abbrev": "Stage 2 Separation", "description": "Separation of the second stage from the first" }, "relative_time": "PT5M5S" }, { "type": { "id": 14, "abbrev": "SES-1", "description": "First start of the second engine" }, "relative_time": "PT5M17S" }, { "type": { "id": 20, "abbrev": "SECO-1", "description": "First cut-off of the second engine" }, "relative_time": "PT16M36S" }, { "type": { "id": 78, "abbrev": "Payload Deployment Sequence Start", "description": "Start of the payload deployment sequence" }, "relative_time": "PT16M57S" }, { "type": { "id": 21, "abbrev": "SES-2", "description": "Second start of the second engine" }, "relative_time": "PT1H47M23S" }, { "type": { "id": 22, "abbrev": "SECO-2", "description": "Second cut-off of the second engine" }, "relative_time": "PT1H47M39S" }, { "type": { "id": 79, "abbrev": "Payload Deployment Sequence End", "description": "End of the payload deployment sequence." }, "relative_time": "PT1H48M19S" } ], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/h3-22_image_20230307130808.jpeg", "infographic": null, "program": [], "orbital_launch_attempt_count": 6621, "location_launch_attempt_count": 90, "pad_launch_attempt_count": 11, "agency_launch_attempt_count": 50, "orbital_launch_attempt_count_year": 32, "location_launch_attempt_count_year": 2, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 2, "pad_turnaround": "P346DT22H45M", "mission_patches": [], "type": "detailed" }
