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/17b3c2b4-452b-4861-9e22-7ce06b4c5a8c/?format=api
{ "id": "17b3c2b4-452b-4861-9e22-7ce06b4c5a8c", "url": "https://ll.thespacedevs.com/2.2.0/launch/17b3c2b4-452b-4861-9e22-7ce06b4c5a8c/?format=api", "slug": "long-march-2f-shenzhou-4", "flightclub_url": null, "r_spacex_api_id": null, "name": "Long March 2F | Shenzhou-4", "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-10-25T11:22:31Z", "updates": [], "net": "2002-12-29T16:40:04Z", "net_precision": null, "window_end": "2002-12-29T16:40:04Z", "window_start": "2002-12-29T16:40:04Z", "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": 517, "consecutive_successful_launches": 59, "successful_launches": 503, "failed_launches": 14, "pending_launches": 8, "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": 488, "configuration": { "id": 79, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/79/?format=api", "name": "Long March 2F", "active": false, "reusable": false, "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", "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": 517, "consecutive_successful_launches": 59, "successful_launches": 503, "failed_launches": 14, "pending_launches": 8, "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": [ { "id": 7, "url": "https://ll.thespacedevs.com/2.2.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.2.0/agencies/17/?format=api", "name": "China National Space Administration", "type": "Government" } ], "image_url": "https://thespacedevs-prod.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", "mission_patches": [], "type": { "id": 2, "name": "Human Spaceflight" } } ], "variant": "F", "alias": "", "min_stage": 2, "max_stage": 2, "length": 62.0, "diameter": 3.35, "maiden_flight": "1999-11-19", "launch_cost": null, "launch_mass": 464, "leo_capacity": 8400, "gto_capacity": null, "to_thrust": 5985, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/long_march_2_image_20210908195835.jpeg", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Long_March_2F", "total_launch_count": 7, "consecutive_successful_launches": 7, "successful_launches": 7, "failed_launches": 0, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": { "id": 440, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/flight/440/?format=api", "mission_end": "2003-01-05T11:16:00Z", "destination": "Low Earth Orbit", "launch_crew": [], "onboard_crew": [], "landing_crew": [], "spacecraft": { "id": 421, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/421/?format=api", "name": "Shenzhou 4", "serial_number": "4", "is_placeholder": false, "in_space": false, "time_in_space": "P6DT18H35M56S", "time_docked": "P0D", "flights_count": 1, "mission_ends_count": 1, "status": { "id": 4, "name": "Single Use" }, "description": "The spacecraft was equipped for a manned flight, even featuring a sleeping bag, food, and medication. The windows were constructed of a new material that was designed to stay clear even after reentry to allow an astronaut to confirm that the parachutes have deployed properly. It was said that the spacecraft flown on Shenzhou 4 had no major differences to that used on Shenzhou 5. It flew with the ability for manual control and emergency landing, systems needed for a manned flight. A week before the launch, astronauts trained in the spacecraft to familiarise themselves with its systems.", "spacecraft_config": { "id": 2, "url": "https://ll.thespacedevs.com/2.2.0/config/spacecraft/2/?format=api", "name": "Shenzhou", "type": { "id": 2, "name": "Capsule" }, "agency": { "id": 17, "url": "https://ll.thespacedevs.com/2.2.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-prod.nyc3.digitaloceanspaces.com/media/images/china2520national2520space2520administration_image_20190207032431.jpeg", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/china2520national2520space2520administration_logo_20190207032431.png" }, "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, "payload_return_capacity": null, "flight_life": "200 day design life.", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/shenzhou_image_20190207032522.jpeg", "nation_url": null, "wiki_link": "https://en.wikipedia.org/wiki/Shenzhou_(spacecraft)", "info_link": "" } }, "landing": { "id": 711, "attempt": true, "success": true, "description": "The Shenzhou 4 spacecraft landed in the Dorbnod Banner in Inner Mongolia, China.", "downrange_distance": null, "location": { "id": 21, "name": "Dorbod Banner", "abbrev": "DB", "description": "Dorbod Banner in Ulanqab, Inner Mongolia, China, bordering Mongolia's Dornogovi Province to the northwest.", "location": null, "successful_landings": 10 }, "type": { "id": 4, "name": "Parachute Landing", "abbrev": "PCL", "description": "Unpowered landing using parachute(s)." } }, "docking_events": [] } }, "mission": { "id": 6608, "name": "Shenzhou-4", "description": "Fourth and final test flight of the Shenzhou spacecraft, without crew on board. The spacecraft was flown in the same configuration as a crew-carrying mission, and as such two dummy astronauts were carried on board, as are sleeping bags, food and medication. The control systems were fitted with ability for manual control and emergency landing. The windows were constructed of a new material that was designed to stay clear even after reentry to allow an astronaut to confirm that the parachutes have deployed properly.\r\n\r\nThe spacecraft carried 100 peony seeds to investigate the effect of weightlessness on plants grown from them. The 52 experiments onboard investigated areas in physics, biology, medicine, earth observation, material science, and astronomy.", "launch_designator": null, "type": "Human Exploration", "orbit": { "id": 8, "name": "Low Earth Orbit", "abbrev": "LEO" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 37, "url": "https://ll.thespacedevs.com/2.2.0/pad/37/?format=api", "agency_id": null, "name": "Launch Area 4 (SLS-1 / 921)", "description": "", "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.2.0/location/17/?format=api", "name": "Jiuquan Satellite Launch Center, People's Republic of China", "country_code": "CHN", "description": "Jiuquan Satellite Launch Center is a Chinese spaceport located between the Ejin, Alxa, Inner Mongolia and Hangtian Town, Jinta County, Jiuquan, Gansu Province. It is part of the Dongfeng Aerospace City (Base 10).", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_17_20200803142429.jpg", "timezone_name": "Asia/Shanghai", "total_launch_count": 247, "total_landing_count": 0 }, "country_code": "CHN", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_37_20200803143603.jpg", "total_launch_count": 24, "orbital_launch_attempt_count": 24 }, "infoURLs": [], "vidURLs": [], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/long_march_2_image_20210908195835.jpeg", "infographic": null, "program": [ { "id": 7, "url": "https://ll.thespacedevs.com/2.2.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.2.0/agencies/17/?format=api", "name": "China National Space Administration", "type": "Government" } ], "image_url": "https://thespacedevs-prod.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", "mission_patches": [], "type": { "id": 2, "name": "Human Spaceflight" } } ], "orbital_launch_attempt_count": 4575, "location_launch_attempt_count": 32, "pad_launch_attempt_count": 4, "agency_launch_attempt_count": 13, "orbital_launch_attempt_count_year": 64, "location_launch_attempt_count_year": 2, "pad_launch_attempt_count_year": 2, "agency_launch_attempt_count_year": 5, "pad_turnaround": "P279DT2H25M", "mission_patches": [], "type": "detailed" }
