Launch Instance
API endpoint that returns all Launch objects or a single launch.
EXAMPLE - /launch/
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'
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.0.0/launch/5ca83f30-9e3d-439c-ac1d-b57953943355/?format=api
{ "id": "5ca83f30-9e3d-439c-ac1d-b57953943355", "url": "https://lldev.thespacedevs.com/2.0.0/launch/5ca83f30-9e3d-439c-ac1d-b57953943355/?format=api", "launch_library_id": null, "slug": "long-march-2fg-shenzhou-21", "name": "Long March 2F/G | Shenzhou 21", "status": { "id": 3, "name": "Success" }, "net": "2025-10-31T15:44:46Z", "window_end": "2025-10-31T16:14:00Z", "window_start": "2025-10-31T15:34:00Z", "inhold": false, "tbdtime": false, "tbddate": false, "probability": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 88, "url": "https://lldev.thespacedevs.com/2.0.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": 554, "consecutive_successful_launches": 96, "successful_launches": 540, "failed_launches": 14, "pending_launches": 4, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://english.spacechina.com/", "wiki_url": "https://en.wikipedia.org/wiki/China_Aerospace_Science_and_Technology_Corporation", "logo_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_logo_20220826093937.png", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_image_20191228094408.jpeg", "nation_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_nation_20230604193716.png" }, "rocket": { "id": 8559, "configuration": { "id": 84, "launch_library_id": 111, "url": "https://lldev.thespacedevs.com/2.0.0/config/launcher/84/?format=api", "name": "Long March 2", "description": "The Long March 2F is a Chinese orbital carrier rocket, part of the Long March 2 rocket family. Designed to launch the crewed Shenzhou spacecraft, the Long March 2F is a human-rated two-stage version of the Long March 2E rocket, which in turn was based on the Long March 2C launch vehicle. It is launched from complex SLS at the Jiuquan Satellite Launch Center.", "family": "Long March", "full_name": "Long March 2F/G", "manufacturer": { "id": 88, "url": "https://lldev.thespacedevs.com/2.0.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": 554, "consecutive_successful_launches": 96, "successful_launches": 540, "failed_launches": 14, "pending_launches": 4, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://english.spacechina.com/", "wiki_url": "https://en.wikipedia.org/wiki/China_Aerospace_Science_and_Technology_Corporation", "logo_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_logo_20220826093937.png", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_image_20191228094408.jpeg", "nation_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_nation_20230604193716.png" }, "program": [], "variant": "F/G", "alias": "", "min_stage": 2, "max_stage": 2, "length": 62.0, "diameter": 3.35, "maiden_flight": "2011-10-31", "launch_mass": 464, "leo_capacity": 8399, "gto_capacity": null, "to_thrust": null, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/long_march_2_image_20210908195835.jpeg", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Long_March_2F/G", "total_launch_count": 19, "consecutive_successful_launches": 19, "successful_launches": 19, "failed_launches": 0, "pending_launches": 0 }, "launcher_stage": [], "spacecraft_stage": { "id": 875, "url": "https://lldev.thespacedevs.com/2.0.0/spacecraft/flight/875/?format=api", "mission_end": "2025-11-14T08:40:00Z", "destination": "Tiangong space station", "launch_crew": [ { "id": 5169, "role": "Operator", "astronaut": { "id": 864, "url": "https://lldev.thespacedevs.com/2.0.0/astronaut/864/?format=api", "name": "Fei Wu", "type": { "id": 2, "name": "Government" }, "status": { "id": 1, "name": "Active" }, "agency": { "id": 17, "url": "https://lldev.thespacedevs.com/2.0.0/agencies/17/?format=api", "name": "China National Space Administration", "type": "Government" }, "date_of_birth": "1993-10-01", "date_of_death": null, "nationality": "Chinese", "twitter": null, "instagram": null, "bio": "Wu Fei is a Chinese astronaut selected as part of the Shenzhou program. He enlisted in the People's Liberation Army (PLA) Air Force in January 2021, and joined the Chinese Communist Party (CCP) in October 2015. He was a engineer at the China Academy of Space Technology (CAST) prior to joining the astronaut corps.", "profile_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/fei_wu_image_20251030081821.jpg", "wiki": null, "last_flight": "2025-10-31T15:44:46Z", "first_flight": "2025-10-31T15:44:46Z" } }, { "id": 5170, "role": "Operator", "astronaut": { "id": 865, "url": "https://lldev.thespacedevs.com/2.0.0/astronaut/865/?format=api", "name": "Hongzhang Zhang", "type": { "id": 2, "name": "Government" }, "status": { "id": 1, "name": "Active" }, "agency": { "id": 17, "url": "https://lldev.thespacedevs.com/2.0.0/agencies/17/?format=api", "name": "China National Space Administration", "type": "Government" }, "date_of_birth": "1986-04-01", "date_of_death": null, "nationality": "Chinese", "twitter": null, "instagram": null, "bio": "Zhang Hongzhang is a Chinese astronaut selected as a payload specialist as part of the Shenzhou program. He joined the Chinese Communist Party (CCP) in August 2004. He was a researcher on battery technology at the Chinese Academy of Sciences (CAS) Dalian Institute of Chemical Physics prior to joining the astronaut corps.", "profile_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/hongzhang_zhang_image_20251030081806.jpg", "wiki": null, "last_flight": "2025-10-31T15:44:46Z", "first_flight": "2025-10-31T15:44:46Z" } }, { "id": 3754, "role": "Operator", "astronaut": { "id": 752, "url": "https://lldev.thespacedevs.com/2.0.0/astronaut/752/?format=api", "name": "Zhang Lu", "type": { "id": 2, "name": "Government" }, "status": { "id": 1, "name": "Active" }, "agency": { "id": 17, "url": "https://lldev.thespacedevs.com/2.0.0/agencies/17/?format=api", "name": "China National Space Administration", "type": "Government" }, "date_of_birth": "1976-11-01", "date_of_death": null, "nationality": "Chinese", "twitter": null, "instagram": null, "bio": "Zhang Lu is a Chinese pilot selected in 2010 to be an astronaut.", "profile_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/zhang_lu_offici_image_20251030081918.jpg", "wiki": null, "last_flight": "2025-10-31T15:44:46Z", "first_flight": "2022-11-29T15:08:17Z" } } ], "onboard_crew": [], "landing_crew": [ { "id": 3684, "role": "Commander", "astronaut": { "id": 86, "url": "https://lldev.thespacedevs.com/2.0.0/astronaut/86/?format=api", "name": "Chen Dong", "type": { "id": 2, "name": "Government" }, "status": { "id": 1, "name": "Active" }, "agency": { "id": 17, "url": "https://lldev.thespacedevs.com/2.0.0/agencies/17/?format=api", "name": "China National Space Administration", "type": "Government" }, "date_of_birth": "1978-12-12", "date_of_death": null, "nationality": "Chinese", "twitter": null, "instagram": null, "bio": "Chen Dong (simplified Chinese: 陈冬; traditional Chinese: 陳冬; pinyin: Chén Dōng; born 12 December 1978) is a Chinese pilot and astronaut selected as part of the Shenzhou program.\r\n\r\nHe was selected to fly on the Shenzhou 11 mission in October 2016 with astronaut Jing Haipeng. The two underwent more than 3,000 hours of training before the launch of the spacecraft. On 17 October 2016 On 07:30 local time (23:30 GMT on 16 October), Chen lifted off with Shenzhou 11 for a 33-day space mission to the Tiangong-2 space station as his first spaceflight, launched from the Jiuquan Satellite Launch Center using a Long March 2F launch rocket. The crew landed successfully after the 33 day mission on 18 November 2016, marking China's longest manned space flight to date. The reentry module of the Shenzhou-11 spacecraft landed in Inner Mongolia around 2.15 p.m(China time) after detaching from the space lab on 17 November.", "profile_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/chen_dong_image_20220604084758.png", "wiki": "https://en.wikipedia.org/wiki/Chen_Dong_(astronaut)", "last_flight": "2025-04-24T09:17:31Z", "first_flight": "2016-10-16T23:30:31Z" } }, { "id": 5092, "role": "Operator", "astronaut": { "id": 841, "url": "https://lldev.thespacedevs.com/2.0.0/astronaut/841/?format=api", "name": "Jie Wang", "type": { "id": 2, "name": "Government" }, "status": { "id": 1, "name": "Active" }, "agency": { "id": 17, "url": "https://lldev.thespacedevs.com/2.0.0/agencies/17/?format=api", "name": "China National Space Administration", "type": "Government" }, "date_of_birth": "1989-09-01", "date_of_death": null, "nationality": "Chinese", "twitter": null, "instagram": null, "bio": "Wang Jie is a Chinese astronaut selected as part of the Shenzhou program. He joined the Chinese Communist Party (CCP) in June 2009 and enlisted in the People's Liberation Army (PLA) in January 2021. Prior to being chosen into the astronaut corps, he worked as a engineer at the China Aerospace Science and Technology Corporation (CASC).", "profile_image": null, "wiki": null, "last_flight": "2025-04-24T09:17:31Z", "first_flight": "2025-04-24T09:17:31Z" } }, { "id": 5091, "role": "Operator", "astronaut": { "id": 840, "url": "https://lldev.thespacedevs.com/2.0.0/astronaut/840/?format=api", "name": "Zhongrui Chen", "type": { "id": 2, "name": "Government" }, "status": { "id": 1, "name": "Active" }, "agency": { "id": 17, "url": "https://lldev.thespacedevs.com/2.0.0/agencies/17/?format=api", "name": "China National Space Administration", "type": "Government" }, "date_of_birth": "1984-10-01", "date_of_death": null, "nationality": "Chinese", "twitter": null, "instagram": null, "bio": "Chen Zhongrui is a Chinese pilot and astronaut selected as part of the Shenzhou program. He enlisted in the People's Liberation Army (PLA) Air Force in September 2003, and joined the Chinese Communist Party (CCP) in June 2005. He was a PLAAF flight instructor prior to joining the astronaut corps.", "profile_image": null, "wiki": null, "last_flight": "2025-04-24T09:17:31Z", "first_flight": "2025-04-24T09:17:31Z" } } ], "spacecraft": { "id": 610, "url": "https://lldev.thespacedevs.com/2.0.0/spacecraft/610/?format=api", "name": "Shenzhou 21", "serial_number": "21", "status": { "id": 1, "name": "Active" }, "description": "Spacecraft used to launch 3 astronauts on the 10th crewed mission to the Chinese Space Station.", "spacecraft_config": { "id": 2, "url": "https://lldev.thespacedevs.com/2.0.0/config/spacecraft/2/?format=api", "name": "Shenzhou", "type": { "id": 2, "name": "Capsule" }, "agency": { "id": 17, "url": "https://lldev.thespacedevs.com/2.0.0/agencies/17/?format=api", "name": "China National Space Administration", "featured": true, "type": "Government", "country_code": "CHN", "abbrev": "CNSA", "description": "The China National Space Administration (CNSA) is the national space agency of the People's Republic of China. It is responsible for the national space program and for planning and development of space activities. CNSA and China Aerospace Corporation (CASC) assumed the authority over space development efforts previously held by the Ministry of Aerospace Industry. The CNSA has many launch sites around China with their orbital sites located in Jiuquan, Xichang, Taiyuan and Wenchang.", "administrator": "Administrator: Tang Dengjie", "founding_year": "1993", "launchers": "", "spacecraft": "Shenzhou", "parent": null, "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/china2520national2520space2520administration_image_20190207032431.jpeg" }, "in_use": true, "capability": "Chinese crewed spaceflight program.", "history": "Shenzhou is a spacecraft used to support the Chinese manned spaceflight program and to carry crew to the Tiangong Space Station. Its design resembles the Russian Soyuz spacecraft, but it is larger in size and all-new in construction. The first launch was on November 19, 1999 and the first manned launch was on October 15, 2003.", "details": "The Shenzhou spacecraft resembles the Soyuz, although it is longer, with a larger habitable volume. It features a powered service module like the Soyuz, and prior to Shenzhou 8 its orbital module was capable of autonomous flight. \r\n\r\nThe aft service module contains life support and other equipment required for the functioning of Shenzhou.", "maiden_flight": "1999-11-19", "height": 9.25, "diameter": 2.8, "human_rated": true, "crew_capacity": 3, "payload_capacity": null, "flight_life": "200 day design life.", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/shenzhou_image_20190207032522.jpeg", "nation_url": null, "wiki_link": "https://en.wikipedia.org/wiki/Shenzhou_(spacecraft)", "info_link": "" } }, "docking_events": [ { "spacestation": { "id": 18, "url": "https://lldev.thespacedevs.com/2.0.0/spacestation/18/?format=api", "name": "Tiangong space station", "status": { "id": 1, "name": "Active" }, "founded": "2021-04-29", "description": "The Tiangong space station is a space station placed in Low Earth orbit between 340 and 450 km above the surface. It will be roughly one-fifth the mass of the International Space Station and about the size of the Mir space station.", "orbit": "Low Earth Orbit", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/tiangong_space__image_20231031004146.png" }, "docking": "2025-10-31T19:22:00Z", "departure": "2025-11-14T03:14:00Z", "docking_location": { "id": 33, "name": "Tianhe forward" } } ] } }, "mission": { "id": 7150, "launch_library_id": null, "name": "Shenzhou 21", "description": "Tenth crewed flight to the Chinese space station.", "launch_designator": null, "type": "Human Exploration", "orbit": { "id": 8, "name": "Low Earth Orbit", "abbrev": "LEO" } }, "pad": { "id": 37, "url": "https://lldev.thespacedevs.com/2.0.0/pad/37/?format=api", "agency_id": null, "name": "Launch Area 4 (SLS-1 / 921)", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Jiuquan_Launch_Area_4", "map_url": "https://www.google.com/maps?q=40.957893,100.290944", "latitude": "40.957893", "longitude": "100.290944", "location": { "id": 17, "url": "https://lldev.thespacedevs.com/2.0.0/location/17/?format=api", "name": "Jiuquan Satellite Launch Center, People's Republic of China", "country_code": "CHN", "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/location_17_20200803142429.jpg", "total_launch_count": 264, "total_landing_count": 0 }, "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/pad_37_20200803143603.jpg", "total_launch_count": 26 }, "infoURLs": [], "vidURLs": [ { "priority": 10, "title": "Live: Special coverage of China's Shenzhou-21 crewed spacecraft launch", "description": "China sends its Shenzhou-21 crewed spacecraft to its space station from the Jiuquan Satellite Launch Center in northwest China at 11:44 p.m. on Friday (Beijing Time). Chinese astronauts Zhang Lu, Wu F...", "feature_image": "https://i.ytimg.com/vi/uUNigRue9jM/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=uUNigRue9jM" }, { "priority": 11, "title": "LIVE: Launch of China's Shenzhou-21 Manned Spacecraft", "description": "China launches its Shenzhou-21 crewed spaceship on Oct. 31 from the Jiuquan Satellite Launch Center in northwest China, sending astronauts Zhang Lu, Wu Fei and Zhang Hongzhang to China's Tiangong spac...", "feature_image": "https://i.ytimg.com/vi/QIHQpGeg9wM/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=QIHQpGeg9wM" } ], "webcast_live": false, "image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/long_march_2_image_20210908195835.jpeg", "infographic": null, "program": [ { "id": 19, "url": "https://lldev.thespacedevs.com/2.0.0/program/19/?format=api", "name": "Tiangong space station", "description": "The Tiangong space station is a space station placed in Low Earth orbit between 340 and 450 km above the surface.", "agencies": [ { "id": 88, "url": "https://lldev.thespacedevs.com/2.0.0/agencies/88/?format=api", "name": "China Aerospace Science and Technology Corporation", "type": "Government" } ], "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/chinese2520spa_program_20210608105528.png", "start_date": "2021-04-29T03:23:00Z", "end_date": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Tiangong_space_station" }, { "id": 7, "url": "https://lldev.thespacedevs.com/2.0.0/program/7/?format=api", "name": "Shenzhou", "description": "The Shenzhou program is a crewed spaceflight initiative by China. The program put the first Chinese citizen, Yang Liwei, into orbit on 15 October 2003.", "agencies": [ { "id": 17, "url": "https://lldev.thespacedevs.com/2.0.0/agencies/17/?format=api", "name": "China National Space Administration", "type": "Government" } ], "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/shenzhou_program_20200820204745.PNG", "start_date": "1993-01-01T00:00:00Z", "end_date": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Shenzhou_program" } ], "orbital_launch_attempt_count": 7101, "location_launch_attempt_count": 262, "pad_launch_attempt_count": 26, "agency_launch_attempt_count": 551, "orbital_launch_attempt_count_year": 252, "location_launch_attempt_count_year": 23, "pad_launch_attempt_count_year": 2, "agency_launch_attempt_count_year": 50 }
