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/91f83c5a-f370-451e-8767-3bbc2144c516/?format=api
{ "id": "91f83c5a-f370-451e-8767-3bbc2144c516", "url": "https://ll.thespacedevs.com/2.2.0/launch/91f83c5a-f370-451e-8767-3bbc2144c516/?format=api", "slug": "long-march-3b-chinasat-9b", "flightclub_url": null, "r_spacex_api_id": null, "name": "Long March 3B | ChinaSat 9B", "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:43Z", "updates": [ { "id": 807, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Launch success.", "info_url": "https://mp.weixin.qq.com/s/uT-i_eAuCQwB0Bw2KWe7Ug", "created_by": "Cosmic_Penguin", "created_on": "2021-09-09T12:26:53Z" }, { "id": 798, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Added launch per NOTAMs.", "info_url": "https://forum.nasaspaceflight.com/index.php?topic=54155.msg2286543#msg2286543", "created_by": "Cosmic_Penguin", "created_on": "2021-09-07T15:33:23Z" } ], "net": "2021-09-09T11:50:00Z", "net_precision": null, "window_end": "2021-09-09T12:09:00Z", "window_start": "2021-09-09T11:39:00Z", "probability": null, "weather_concerns": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 88, "url": "https://ll.thespacedevs.com/2.2.0/agencies/88/?format=api", "name": "China Aerospace Science and Technology Corporation", "featured": true, "type": "Government", "country_code": "CHN", "abbrev": "CASC", "description": "The China Aerospace Science and Technology Corporation (CASC) is the main contractor for the Chinese space program. It is state-owned and has a number of subordinate entities which design, develop and manufacture a range of spacecraft, launch vehicles, strategic and tactical missile systems, and ground equipment. It was officially established in July 1999 as part of a Chinese government reform drive, having previously been one part of the former China Aerospace Corporation. Various incarnations of the program date back to 1956.", "administrator": "Chairman & President: Lei Fanpei", "founding_year": "1999", "launchers": "Long March", "spacecraft": "", "launch_library_url": null, "total_launch_count": 523, "consecutive_successful_launches": 65, "successful_launches": 509, "failed_launches": 14, "pending_launches": 9, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "http://english.spacechina.com/", "wiki_url": "https://en.wikipedia.org/wiki/China_Aerospace_Science_and_Technology_Corporation", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_logo_20220826093937.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_image_20191228094408.jpeg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_nation_20230604193716.png" }, "rocket": { "id": 7445, "configuration": { "id": 50, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/50/?format=api", "name": "Long March 3", "active": true, "reusable": false, "description": "The Long March 3B / E (G2) (CZ-3B / E) is one of the most successful medium-range launchers and the strongest variant of the CZ-3 series.\r\nIt was specially developed for the transport of heavy communications satellites into a geostationary transfer orbit.\r\n\r\nThe additional designation \"E\" stands for a higher payload fairing, stretched boosters and extended fuel tanks at the first stage, over the CZ-3B.", "family": "Long March", "full_name": "Long March 3B/E", "manufacturer": { "id": 88, "url": "https://ll.thespacedevs.com/2.2.0/agencies/88/?format=api", "name": "China Aerospace Science and Technology Corporation", "featured": true, "type": "Government", "country_code": "CHN", "abbrev": "CASC", "description": "The China Aerospace Science and Technology Corporation (CASC) is the main contractor for the Chinese space program. It is state-owned and has a number of subordinate entities which design, develop and manufacture a range of spacecraft, launch vehicles, strategic and tactical missile systems, and ground equipment. It was officially established in July 1999 as part of a Chinese government reform drive, having previously been one part of the former China Aerospace Corporation. Various incarnations of the program date back to 1956.", "administrator": "Chairman & President: Lei Fanpei", "founding_year": "1999", "launchers": "Long March", "spacecraft": "", "launch_library_url": null, "total_launch_count": 523, "consecutive_successful_launches": 65, "successful_launches": 509, "failed_launches": 14, "pending_launches": 9, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "http://english.spacechina.com/", "wiki_url": "https://en.wikipedia.org/wiki/China_Aerospace_Science_and_Technology_Corporation", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_logo_20220826093937.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_image_20191228094408.jpeg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_nation_20230604193716.png" }, "program": [], "variant": "B/E", "alias": "CZ-3B/E", "min_stage": 3, "max_stage": 3, "length": 56.3, "diameter": 3.35, "maiden_flight": "2007-05-13", "launch_cost": "70000000", "launch_mass": 456, "leo_capacity": 12000, "gto_capacity": 5500, "to_thrust": 5924, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/long2520march25203_image_20190222031215.jpeg", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Long_March_3B", "total_launch_count": 69, "consecutive_successful_launches": 46, "successful_launches": 68, "failed_launches": 1, "pending_launches": 2, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 5838, "name": "ChinaSat 9B", "description": "Zhongxing-9B (ChinaSat 9B) is a Chinese communications satellite, that will replace the Zhongxing-9A satellite in orbit. The latter was launched in 2017, but the CZ-3B launch vehicle suffered a partial failure, and the satellite had to burn a large amount of fuel to reach its nominal orbit.\r\n\r\nZX-9B will be used to retransmit television to the Chinese, as well as to provide television communications with Chinese islands, and ships sailing near the coast. The satellite will also be used to broadcast the 2022 Beijing Winter Olympics in 8K.", "launch_designator": null, "type": "Communications", "orbit": { "id": 2, "name": "Geostationary Transfer Orbit", "abbrev": "GTO" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 45, "url": "https://ll.thespacedevs.com/2.2.0/pad/45/?format=api", "agency_id": null, "name": "Launch Complex 2 (LC-2)", "description": "", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Xichang_Satellite_Launch_Center", "map_url": "https://www.google.com/maps?q=28.245564,102.026751", "latitude": "28.245564", "longitude": "102.026751", "location": { "id": 16, "url": "https://ll.thespacedevs.com/2.2.0/location/16/?format=api", "name": "Xichang Satellite Launch Center, People's Republic of China", "country_code": "CHN", "description": "The Xichang Satellite Launch Center is a spaceport in China. It is located in Zeyuan Town, northwest of Xichang, Liangshan Yi Autonomous Prefecture in Sichuan.", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_16_20200803142513.jpg", "timezone_name": "Asia/Shanghai", "total_launch_count": 225, "total_landing_count": 0 }, "country_code": "CHN", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_45_20200803143520.jpg", "total_launch_count": 118, "orbital_launch_attempt_count": 118 }, "infoURLs": [], "vidURLs": [ { "priority": 10, "source": null, "publisher": null, "title": "Long March-3B launches ChinaSat-9B (ZhongXing-9B)", "description": "A Long March-3B rocket launched the ChinaSat-9B satellite from the Xichang Satellite Launch Center, Sichuan Province, southwest China, on 9 September 2021, a...", "feature_image": "https://i.ytimg.com/vi/qKE0581QDIo/hqdefault.jpg", "url": "https://www.youtube.com/watch?v=qKE0581QDIo", "type": null, "language": null, "start_time": null, "end_time": null } ], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/long2520march25203_image_20190222031215.jpeg", "infographic": null, "program": [], "orbital_launch_attempt_count": 6124, "location_launch_attempt_count": 161, "pad_launch_attempt_count": 94, "agency_launch_attempt_count": 335, "orbital_launch_attempt_count_year": 87, "location_launch_attempt_count_year": 10, "pad_launch_attempt_count_year": 5, "agency_launch_attempt_count_year": 31, "pad_turnaround": "P34DT19H19M56S", "mission_patches": [], "type": "detailed" }
