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/7614f1a3-2ffe-4334-82b1-58aab43fe6d6/?format=api
{ "id": "7614f1a3-2ffe-4334-82b1-58aab43fe6d6", "url": "https://ll.thespacedevs.com/2.2.0/launch/7614f1a3-2ffe-4334-82b1-58aab43fe6d6/?format=api", "slug": "h-iia-202-igs-optical-7", "flightclub_url": null, "r_spacex_api_id": null, "name": "H-IIA 202 | IGS Optical 7", "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-06-14T03:53:08Z", "updates": [], "net": "2020-02-09T01:34:00Z", "net_precision": null, "window_end": "2020-02-09T01:39:00Z", "window_start": "2020-02-09T01:34:00Z", "probability": -1, "weather_concerns": null, "holdreason": "", "failreason": null, "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": 2598, "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": 1077, "name": "IGS Optical 7", "description": "Information Gathering Satellite (IGS) is a Japanese governmental spy satellite program. IGS Optical 7, as the name suggests, is an optical reconnaissance satellite.\n\nJapan began development of IGS in the late 1990s, following North Korea’s attempted satellite launch in 1998. Although the North Korean launch failed to reach orbit, the rocket carrying it crossed Japan during its ascent, sparking fears that North Korean missiles would be able to target the islands. With IGS, Japan aimed to develop an independent reconnaissance capability to monitor future threats. The constellation can also be used for disaster monitoring and other civilian applications by the Japanese government.", "launch_designator": null, "type": "Government/Top Secret", "orbit": { "id": 17, "name": "Sun-Synchronous Orbit", "abbrev": "SSO" }, "agencies": [], "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": 0, "source": null, "publisher": null, "title": "【現地中継】H-2Aロケット41号機 情報収集衛星 光学7号機 再打上げ / H-2A Rocket F41 IGS Optical-7 Re-Launch", "description": "2月9日 10:34～10:39頃に予定されている H-2Aロケット41号機打上げの様子を 現地、種子島から中継します。 打上げ予定日(Launch Date）：2020.02.09 打上げ予定時刻(Launch Time)：TBD +0900（JST） 打上げ時間帯（launch window）：10:34～1...", "feature_image": "https://i.ytimg.com/vi/OBtfD_uvBJg/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=OBtfD_uvBJg", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 0, "source": null, "publisher": null, "title": "H-2Aロケット41号機 情報収集衛星 光学7号 打上げ中止に関する記者会見", "description": "機体に窒素ガス空調を供給する設備配管に過大な外部漏洩が発生していることが判明したため、28日の打上げを中止したH-2Aロケット41号機についての会見を中継します", "feature_image": "https://i.ytimg.com/vi/y5fNEf5ANdQ/hqdefault.jpg", "url": "https://www.youtube.com/watch?v=y5fNEf5ANdQ", "type": null, "language": null, "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": 5931, "location_launch_attempt_count": 80, "pad_launch_attempt_count": 48, "agency_launch_attempt_count": 41, "orbital_launch_attempt_count_year": 9, "location_launch_attempt_count_year": 1, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 1, "pad_turnaround": "P467DT21H26M", "mission_patches": [], "type": "detailed" }
