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/987a9028-777e-4c9c-a5b1-a4e2e213768c/?format=api
{ "id": "987a9028-777e-4c9c-a5b1-a4e2e213768c", "url": "https://ll.thespacedevs.com/2.2.0/launch/987a9028-777e-4c9c-a5b1-a4e2e213768c/?format=api", "slug": "long-march-4c-queqiao-change-4-relay-satellite", "flightclub_url": null, "r_spacex_api_id": null, "name": "Long March 4C | Queqiao (Chang'e 4 relay satellite)", "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:56:40Z", "updates": [], "net": "2018-05-20T21:28:49Z", "net_precision": null, "window_end": "2018-05-20T23:10:00Z", "window_start": "2018-05-20T21:25:00Z", "probability": -1, "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": 2103, "configuration": { "id": 64, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/64/?format=api", "name": "Long March 4C", "active": true, "reusable": false, "description": "The Long March 4C, also known as the Chang Zheng 4C, CZ-4C and LM-4C, previously designated Long March 4B-II, is a Chinese orbital carrier rocket. It is launched from the Jiuquan, Taiyuan Satellite Launch Centre and Xichangs, and consists of 3 stages. Long March 4C vehicles have been used to launch the Yaogan-1, Yaogan-3 SAR satellites and the Fengyun-3A polar orbiting meteorological satellite. On December 15, 2009 a Long March 4C was used to launch Yaogan 8.", "family": "Long March", "full_name": "Long March 4C", "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": "C", "alias": "", "min_stage": 3, "max_stage": 3, "length": null, "diameter": null, "maiden_flight": "2006-04-26", "launch_cost": null, "launch_mass": null, "leo_capacity": null, "gto_capacity": null, "to_thrust": null, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/long_march_4c_image_20230801172338.jpeg", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Long_March_4C", "total_launch_count": 56, "consecutive_successful_launches": 30, "successful_launches": 54, "failed_launches": 2, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 811, "name": "Queqiao (Chang'e 4 relay satellite)", "description": "Chang'e 4 is a Chinese lunar exploration mission that will incorporate an orbiter, a robotic lander and rover. The orbiter serves as a communications relay satellite. It will be placed into a halo orbit around the Earth-Moon L2 Lagrange point and is planned to support further missions to the far side of the Moon.", "launch_designator": null, "type": "Planetary Science", "orbit": { "id": 11, "name": "Lunar Orbit", "abbrev": "LO" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 66, "url": "https://ll.thespacedevs.com/2.2.0/pad/66/?format=api", "agency_id": 17, "name": "Launch Complex 3 (LC-3/LA-1)", "description": "", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Xichang_Satellite_Launch_Center", "map_url": "https://www.google.com/maps?q=28.247209,102.02917", "latitude": "28.247209", "longitude": "102.02917", "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_66_20200803143611.jpg", "total_launch_count": 100, "orbital_launch_attempt_count": 100 }, "infoURLs": [], "vidURLs": [ { "priority": 0, "source": null, "publisher": null, "title": "Long March-4C launches Queqiao (Chang'e-4 relay satellite/ 鹊桥)", "description": "A Long March-4C launch vehicle launched Queqiao (鹊桥, “Magpie Bridge”), the relay satellite for the Chang'e-4 lunar mission, from the Xichang Satellite Launch...", "feature_image": "https://i.ytimg.com/vi/8bHeWdw-PHM/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=8bHeWdw-PHM", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 0, "source": null, "publisher": null, "title": "China launches relay satellite for Chang'e-4 lunar probe", "description": "China on Monday successfully launched a relay satellite for the Chang'e-4 lunar mission, which is scheduled for later this year. The satellite, named Queqiao...", "feature_image": "https://i.ytimg.com/vi/TC1bsPDsKgQ/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=TC1bsPDsKgQ", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 0, "source": null, "publisher": null, "title": "China Launches Relay Satellite to Explore Moon's Far Side", "description": "China launched a relay satellite early Monday to set up a communication link between Earth and the planned Chang'e-4 lunar probe that will explore the myster...", "feature_image": "https://i.ytimg.com/vi/Nk79JmmkeCc/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=Nk79JmmkeCc", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 0, "source": null, "publisher": null, "title": "Full Video: China launches relay satellite to explore far side of the Moon", "description": "China launched a relay satellite early Monday to set up a communication link between Earth and the planned Chang'e-4 lunar probe that will explore the myster...", "feature_image": "https://i.ytimg.com/vi/EYMyZE7SAME/maxresdefault.jpg", "url": "https://youtube.com/watch?v=EYMyZE7SAME", "type": null, "language": null, "start_time": null, "end_time": null } ], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/long_march_4c_image_20230801172338.jpeg", "infographic": null, "program": [ { "id": 18, "url": "https://ll.thespacedevs.com/2.2.0/program/18/?format=api", "name": "Chinese Lunar Exploration Program", "description": "The Chinese Lunar Exploration Program also known as the Chang'e Project after the Chinese moon goddess Chang'e, is an ongoing series of robotic Moon missions by the China National Space Administration (CNSA). The program incorporates lunar orbiters, landers, rovers and sample return spacecraft, launched using Long March rockets.", "agencies": [ { "id": 17, "url": "https://ll.thespacedevs.com/2.2.0/agencies/17/?format=api", "name": "China National Space Administration", "type": "Government" } ], "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/chinese2520lun_program_20201129190923.png", "start_date": "2003-01-01T00:00:00Z", "end_date": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Chinese_Lunar_Exploration_Program", "mission_patches": [], "type": { "id": 5, "name": "Exploration" } } ], "orbital_launch_attempt_count": 5751, "location_launch_attempt_count": 114, "pad_launch_attempt_count": 43, "agency_launch_attempt_count": 222, "orbital_launch_attempt_count_year": 45, "location_launch_attempt_count_year": 6, "pad_launch_attempt_count_year": 3, "agency_launch_attempt_count_year": 15, "pad_turnaround": "P115DT15H49M45S", "mission_patches": [], "type": "detailed" }
