Launch Instance
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'
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/2f8aff8b-85da-42bf-84eb-6d3b10184c44/?format=api
{ "id": "2f8aff8b-85da-42bf-84eb-6d3b10184c44", "url": "https://ll.thespacedevs.com/2.0.0/launch/2f8aff8b-85da-42bf-84eb-6d3b10184c44/?format=api", "launch_library_id": null, "slug": "long-march-2fg-shenzhou-16", "name": "Long March 2F/G | Shenzhou 16", "status": { "id": 3, "name": "Success" }, "net": "2023-05-30T01:31:10Z", "window_end": "2023-05-30T02:01:00Z", "window_start": "2023-05-30T01:21:00Z", "inhold": false, "tbdtime": false, "tbddate": false, "probability": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 88, "url": "https://ll.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": 472, "consecutive_successful_launches": 11, "successful_launches": 458, "failed_launches": 14, "pending_launches": 7, "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://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_logo_20220826093937.png", "image_url": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_image_20191228094408.jpeg", "nation_url": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_nation_20230604193716.png" }, "rocket": { "id": 7826, "configuration": { "id": 84, "launch_library_id": 111, "url": "https://ll.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://ll.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": 472, "consecutive_successful_launches": 11, "successful_launches": 458, "failed_launches": 14, "pending_launches": 7, "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://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_logo_20220826093937.png", "image_url": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_image_20191228094408.jpeg", "nation_url": "https://spacelaunchnow-prod-east.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://spacelaunchnow-prod-east.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": 16, "consecutive_successful_launches": 16, "successful_launches": 16, "failed_launches": 0, "pending_launches": 1 }, "launcher_stage": [], "spacecraft_stage": { "id": 803, "url": "https://ll.thespacedevs.com/2.0.0/spacecraft/flight/803/?format=api", "mission_end": "2023-10-31T00:12:00Z", "destination": "Tiangong space station", "launch_crew": [ { "id": 4728, "role": "Commander", "astronaut": { "id": 157, "url": "https://ll.thespacedevs.com/2.0.0/astronaut/157/?format=api", "name": "Jing Haipeng", "type": { "id": 2, "name": "Government" }, "status": { "id": 1, "name": "Active" }, "agency": { "id": 17, "url": "https://ll.thespacedevs.com/2.0.0/agencies/17/?format=api", "name": "China National Space Administration", "type": "Government" }, "date_of_birth": "1966-10-24", "date_of_death": null, "nationality": "Chinese", "twitter": null, "instagram": null, "bio": "Jing Haipeng (simplified Chinese: 景海鹏; traditional Chinese: 景海鵬; pinyin: Jǐng Hǎipéng; born October 24, 1966) is a Chinese pilot and astronaut selected as part of the Shenzhou program. A fighter pilot in the People's Liberation Army Air Force, he was selected to be a CNSA astronaut in 1998. He is the first Chinese astronaut to have flown on three missions: Shenzhou 7, Shenzhou 9 and Shenzhou 11.", "profile_image": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/jing2520haipeng_image_20181129231707.jpg", "wiki": "https://en.wikipedia.org/wiki/Jing_Haipeng", "last_flight": "2023-05-30T01:31:10Z", "first_flight": "2008-09-25T13:10:04Z" } }, { "id": 4730, "role": "Engineer", "astronaut": { "id": 764, "url": "https://ll.thespacedevs.com/2.0.0/astronaut/764/?format=api", "name": "Yangzhu Zhu", "type": { "id": 2, "name": "Government" }, "status": { "id": 1, "name": "Active" }, "agency": { "id": 17, "url": "https://ll.thespacedevs.com/2.0.0/agencies/17/?format=api", "name": "China National Space Administration", "type": "Government" }, "date_of_birth": "1986-09-01", "date_of_death": null, "nationality": "Chinese", "twitter": null, "instagram": null, "bio": "Zhu Yangzhu is a Chinese pilot and astronaut selected as part of the Shenzhou program. He enlisted in the People's Liberation Army (PLA) in September 2005, and joined the Chinese Communist Party (CCP) in December 2006.", "profile_image": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/yangzhu_zhu_image_20230530052559.jpeg", "wiki": "https://en.wikipedia.org/wiki/Zhu_Yangzhu", "last_flight": "2023-05-30T01:31:10Z", "first_flight": "2023-05-30T01:31:10Z" } }, { "id": 4732, "role": "Payload Specialist", "astronaut": { "id": 765, "url": "https://ll.thespacedevs.com/2.0.0/astronaut/765/?format=api", "name": "Haichao Gui", "type": { "id": 2, "name": "Government" }, "status": { "id": 1, "name": "Active" }, "agency": { "id": 17, "url": "https://ll.thespacedevs.com/2.0.0/agencies/17/?format=api", "name": "China National Space Administration", "type": "Government" }, "date_of_birth": "1986-11-01", "date_of_death": null, "nationality": "Chinese", "twitter": null, "instagram": null, "bio": "Gui Haichao is a Chinese pilot, researcher and professor selected as part of the Shenzhou program. He did nor enlist in the People's Liberation Army (PLA), but was still was selected as a taikonaut, whereas all earlier known taikonauts belonged to PLAAC. He joined the Communist Party of China in July 2020.", "profile_image": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/haichao_gui_image_20230530052736.jpeg", "wiki": "https://en.wikipedia.org/wiki/Gui_Haichao", "last_flight": "2023-05-30T01:31:10Z", "first_flight": "2023-05-30T01:31:10Z" } } ], "onboard_crew": [], "landing_crew": [ { "id": 4729, "role": "Commander", "astronaut": { "id": 157, "url": "https://ll.thespacedevs.com/2.0.0/astronaut/157/?format=api", "name": "Jing Haipeng", "type": { "id": 2, "name": "Government" }, "status": { "id": 1, "name": "Active" }, "agency": { "id": 17, "url": "https://ll.thespacedevs.com/2.0.0/agencies/17/?format=api", "name": "China National Space Administration", "type": "Government" }, "date_of_birth": "1966-10-24", "date_of_death": null, "nationality": "Chinese", "twitter": null, "instagram": null, "bio": "Jing Haipeng (simplified Chinese: 景海鹏; traditional Chinese: 景海鵬; pinyin: Jǐng Hǎipéng; born October 24, 1966) is a Chinese pilot and astronaut selected as part of the Shenzhou program. A fighter pilot in the People's Liberation Army Air Force, he was selected to be a CNSA astronaut in 1998. He is the first Chinese astronaut to have flown on three missions: Shenzhou 7, Shenzhou 9 and Shenzhou 11.", "profile_image": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/jing2520haipeng_image_20181129231707.jpg", "wiki": "https://en.wikipedia.org/wiki/Jing_Haipeng", "last_flight": "2023-05-30T01:31:10Z", "first_flight": "2008-09-25T13:10:04Z" } }, { "id": 4731, "role": "Engineer", "astronaut": { "id": 764, "url": "https://ll.thespacedevs.com/2.0.0/astronaut/764/?format=api", "name": "Yangzhu Zhu", "type": { "id": 2, "name": "Government" }, "status": { "id": 1, "name": "Active" }, "agency": { "id": 17, "url": "https://ll.thespacedevs.com/2.0.0/agencies/17/?format=api", "name": "China National Space Administration", "type": "Government" }, "date_of_birth": "1986-09-01", "date_of_death": null, "nationality": "Chinese", "twitter": null, "instagram": null, "bio": "Zhu Yangzhu is a Chinese pilot and astronaut selected as part of the Shenzhou program. He enlisted in the People's Liberation Army (PLA) in September 2005, and joined the Chinese Communist Party (CCP) in December 2006.", "profile_image": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/yangzhu_zhu_image_20230530052559.jpeg", "wiki": "https://en.wikipedia.org/wiki/Zhu_Yangzhu", "last_flight": "2023-05-30T01:31:10Z", "first_flight": "2023-05-30T01:31:10Z" } }, { "id": 4733, "role": "Payload Specialist", "astronaut": { "id": 765, "url": "https://ll.thespacedevs.com/2.0.0/astronaut/765/?format=api", "name": "Haichao Gui", "type": { "id": 2, "name": "Government" }, "status": { "id": 1, "name": "Active" }, "agency": { "id": 17, "url": "https://ll.thespacedevs.com/2.0.0/agencies/17/?format=api", "name": "China National Space Administration", "type": "Government" }, "date_of_birth": "1986-11-01", "date_of_death": null, "nationality": "Chinese", "twitter": null, "instagram": null, "bio": "Gui Haichao is a Chinese pilot, researcher and professor selected as part of the Shenzhou program. He did nor enlist in the People's Liberation Army (PLA), but was still was selected as a taikonaut, whereas all earlier known taikonauts belonged to PLAAC. He joined the Communist Party of China in July 2020.", "profile_image": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/haichao_gui_image_20230530052736.jpeg", "wiki": "https://en.wikipedia.org/wiki/Gui_Haichao", "last_flight": "2023-05-30T01:31:10Z", "first_flight": "2023-05-30T01:31:10Z" } } ], "spacecraft": { "id": 566, "url": "https://ll.thespacedevs.com/2.0.0/spacecraft/566/?format=api", "name": "Shenzhou 16", "serial_number": "16", "status": { "id": 4, "name": "Single Use" }, "description": "Fifth crewed mission to the Chinese Space Station.", "spacecraft_config": { "id": 2, "url": "https://ll.thespacedevs.com/2.0.0/config/spacecraft/2/?format=api", "name": "Shenzhou", "type": { "id": 2, "name": "Capsule" }, "agency": { "id": 17, "url": "https://ll.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://spacelaunchnow-prod-east.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://spacelaunchnow-prod-east.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://ll.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://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/tiangong_space__image_20231031004146.png" }, "docking": "2023-05-30T08:29:00Z", "departure": "2023-10-30T12:37:00Z", "docking_location": { "id": 41, "name": "Tianhe nadir" } } ] } }, "mission": { "id": 6332, "launch_library_id": null, "name": "Shenzhou 16", "description": "Fifth 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://ll.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://ll.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://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/launch_images/location_17_20200803142429.jpg", "total_launch_count": 225, "total_landing_count": 0 }, "map_image": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/launch_images/pad_37_20200803143603.jpg", "total_launch_count": 23 }, "infoURLs": [], "vidURLs": [ { "priority": 10, "title": "Live: Special coverage of China's Shenzhou-16 manned space mission launch", "description": "China launches its Shenzhou-16 manned spacecraft from the Jiuquan Satellite Launch Center in the northwest. Three Chinese astronauts, or taikonauts, Jing Hai...", "feature_image": "https://i.ytimg.com/vi/RqrUEre6cbE/hqdefault_live.jpg", "url": "https://www.youtube.com/watch?v=RqrUEre6cbE" }, { "priority": 11, "title": "神舟十六号载人飞行任务特别节目", "description": "据中国载人航天工程办公室消息，神舟十六号瞄准5月30日9时31分发射，景海鹏、朱杨柱、桂海潮3名航天员将执行神舟十六号载人飞行任务。神舟十六号载人飞行任务是空间站应用与发展阶段首个载人飞行任务，也是我国第三批航天员首次执行飞行任务，航天飞行工程师和载荷专家迎来“首秀”。", "feature_image": "https://i.ytimg.com/vi/AiS9wWj8BGM/maxresdefault_live.jpg", "url": "https://www.youtube.com/watch?v=AiS9wWj8BGM" } ], "webcast_live": false, "image": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/long2520march_image_20240101085213.jpeg", "infographic": null, "program": [ { "id": 7, "url": "https://ll.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://ll.thespacedevs.com/2.0.0/agencies/17/?format=api", "name": "China National Space Administration", "type": "Government" } ], "image_url": "https://spacelaunchnow-prod-east.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" }, { "id": 19, "url": "https://ll.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://ll.thespacedevs.com/2.0.0/agencies/88/?format=api", "name": "China Aerospace Science and Technology Corporation", "type": "Government" } ], "image_url": "https://spacelaunchnow-prod-east.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" } ], "orbital_launch_attempt_count": 6439, "location_launch_attempt_count": 194, "pad_launch_attempt_count": 20, "agency_launch_attempt_count": 423, "orbital_launch_attempt_count_year": 82, "location_launch_attempt_count_year": 12, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 17 }
