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/f672e9c9-2bae-4adf-ae70-09eda35d9837/?format=api
{ "id": "f672e9c9-2bae-4adf-ae70-09eda35d9837", "url": "https://ll.thespacedevs.com/2.0.0/launch/f672e9c9-2bae-4adf-ae70-09eda35d9837/?format=api", "launch_library_id": 629, "slug": "long-march-2fg-shenzhou-9-shenzhou-9-gc", "name": "Long March 2F/G | Shenzhou-9 & Shenzhou-9-GC", "status": { "id": 3, "name": "Success" }, "net": "2012-06-16T10:37:24Z", "window_end": "2012-06-16T10:37:24Z", "window_start": "2012-06-16T10:37:24Z", "inhold": false, "tbdtime": false, "tbddate": false, "probability": -1, "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": 6, "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": 1616, "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": 6, "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": 445, "url": "https://ll.thespacedevs.com/2.0.0/spacecraft/flight/445/?format=api", "mission_end": "2012-06-29T02:01:16Z", "destination": "Tiangong-1", "launch_crew": [ { "id": 3089, "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": 3092, "role": "Flight Engineer", "astronaut": { "id": 184, "url": "https://ll.thespacedevs.com/2.0.0/astronaut/184/?format=api", "name": "Liu Wang", "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": "1969-03-25", "date_of_death": null, "nationality": "Chinese", "twitter": null, "instagram": null, "bio": "Liu Wang (simplified Chinese: 刘旺; traditional Chinese: 劉旺, born in 1969) is a Chinese pilot selected as part of the Shenzhou program. He was born in the Shanxi province of China and was a fighter pilot in the People's Liberation Army Air Force. He was selected to be an astronaut in 1998.", "profile_image": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/liu2520wang_image_20181129235721.jpg", "wiki": "https://en.wikipedia.org/wiki/Liu_Wang", "last_flight": "2012-06-16T10:37:24Z", "first_flight": "2012-06-16T10:37:24Z" } }, { "id": 3094, "role": "Flight Engineer", "astronaut": { "id": 185, "url": "https://ll.thespacedevs.com/2.0.0/astronaut/185/?format=api", "name": "Liu Yang", "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": "1978-10-06", "date_of_death": null, "nationality": "Chinese", "twitter": null, "instagram": null, "bio": "Liu Yang (born October 6, 1978) is a Chinese pilot and astronaut who served as a crew member on the space mission Shenzhou 9. On June 16, 2012, Liu became the first Chinese woman in space.", "profile_image": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/liu_yang_image_20220604084749.png", "wiki": "https://en.wikipedia.org/wiki/Liu_Yang_(astronaut)", "last_flight": "2022-06-05T02:44:10Z", "first_flight": "2012-06-16T10:37:24Z" } } ], "onboard_crew": [], "landing_crew": [ { "id": 3087, "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": 3093, "role": "Flight Engineer", "astronaut": { "id": 184, "url": "https://ll.thespacedevs.com/2.0.0/astronaut/184/?format=api", "name": "Liu Wang", "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": "1969-03-25", "date_of_death": null, "nationality": "Chinese", "twitter": null, "instagram": null, "bio": "Liu Wang (simplified Chinese: 刘旺; traditional Chinese: 劉旺, born in 1969) is a Chinese pilot selected as part of the Shenzhou program. He was born in the Shanxi province of China and was a fighter pilot in the People's Liberation Army Air Force. He was selected to be an astronaut in 1998.", "profile_image": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/liu2520wang_image_20181129235721.jpg", "wiki": "https://en.wikipedia.org/wiki/Liu_Wang", "last_flight": "2012-06-16T10:37:24Z", "first_flight": "2012-06-16T10:37:24Z" } }, { "id": 3095, "role": "Flight Engineer", "astronaut": { "id": 185, "url": "https://ll.thespacedevs.com/2.0.0/astronaut/185/?format=api", "name": "Liu Yang", "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": "1978-10-06", "date_of_death": null, "nationality": "Chinese", "twitter": null, "instagram": null, "bio": "Liu Yang (born October 6, 1978) is a Chinese pilot and astronaut who served as a crew member on the space mission Shenzhou 9. On June 16, 2012, Liu became the first Chinese woman in space.", "profile_image": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/liu_yang_image_20220604084749.png", "wiki": "https://en.wikipedia.org/wiki/Liu_Yang_(astronaut)", "last_flight": "2022-06-05T02:44:10Z", "first_flight": "2012-06-16T10:37:24Z" } } ], "spacecraft": { "id": 426, "url": "https://ll.thespacedevs.com/2.0.0/spacecraft/426/?format=api", "name": "Shenzhou 9", "serial_number": "9", "status": { "id": 4, "name": "Single Use" }, "description": "Shenzhou 9 was the second spacecraft and first crewed spacecraft to dock with the Tiangong 1 space station, which took place on 18 June.", "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": 7, "url": "https://ll.thespacedevs.com/2.0.0/spacestation/7/?format=api", "name": "Tiangong 1", "status": { "id": 2, "name": "De-Orbited" }, "founded": "2011-09-29", "description": "Tiangong-1 (Chinese: 天宫一号; pinyin: Tiāngōng yīhào; literally: \"Heavenly Palace 1\" or \"Celestial Palace 1\") was China's first prototype space station. It orbited Earth from September 2011 to April 2018, serving as both a manned laboratory and an experimental testbed to demonstrate orbital rendezvous and docking capabilities during its two years of active operational life.\r\n\r\nTiangong-1 was visited by a series of Shenzhou spacecraft during its two-year operational lifetime. The first of these, the unmanned Shenzhou 8, successfully docked with the module in November 2011, while the manned Shenzhou 9 mission docked in June 2012. A third and final mission to Tiangong-1, the manned Shenzhou 10, docked in June 2013. The manned missions to Tiangong-1 were notable for including China's first female astronauts, Liu Yang and Wang Yaping.\r\n\r\nOn 21 March 2016, after a lifespan extended by two years, the China Manned Space Engineering Office announced that Tiangong-1 had officially ended its service. They went on to state that the telemetry link with Tiangong-1 had been lost. A couple of months later, amateur satellite trackers watching Tiangong-1 found that China's space agency had lost control of the station. In September, after conceding they had lost control over the station, officials speculated that the station would re-enter and burn up in the atmosphere late in 2017. According to the China Manned Space Engineering Office, Tiangong-1 started reentry over the southern Pacific Ocean, northwest of Tahiti, on 2 April 2018 at 00:15 UTC.", "orbit": "Low Earth Orbit", "image_url": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/tiangong25201_image_20190215013038.jpeg" }, "docking": "2012-06-18T06:07:00Z", "departure": "2012-06-24T03:08:00Z", "docking_location": { "id": 34, "name": "Tiangong-1 forward" } }, { "spacestation": { "id": 7, "url": "https://ll.thespacedevs.com/2.0.0/spacestation/7/?format=api", "name": "Tiangong 1", "status": { "id": 2, "name": "De-Orbited" }, "founded": "2011-09-29", "description": "Tiangong-1 (Chinese: 天宫一号; pinyin: Tiāngōng yīhào; literally: \"Heavenly Palace 1\" or \"Celestial Palace 1\") was China's first prototype space station. It orbited Earth from September 2011 to April 2018, serving as both a manned laboratory and an experimental testbed to demonstrate orbital rendezvous and docking capabilities during its two years of active operational life.\r\n\r\nTiangong-1 was visited by a series of Shenzhou spacecraft during its two-year operational lifetime. The first of these, the unmanned Shenzhou 8, successfully docked with the module in November 2011, while the manned Shenzhou 9 mission docked in June 2012. A third and final mission to Tiangong-1, the manned Shenzhou 10, docked in June 2013. The manned missions to Tiangong-1 were notable for including China's first female astronauts, Liu Yang and Wang Yaping.\r\n\r\nOn 21 March 2016, after a lifespan extended by two years, the China Manned Space Engineering Office announced that Tiangong-1 had officially ended its service. They went on to state that the telemetry link with Tiangong-1 had been lost. A couple of months later, amateur satellite trackers watching Tiangong-1 found that China's space agency had lost control of the station. In September, after conceding they had lost control over the station, officials speculated that the station would re-enter and burn up in the atmosphere late in 2017. According to the China Manned Space Engineering Office, Tiangong-1 started reentry over the southern Pacific Ocean, northwest of Tahiti, on 2 April 2018 at 00:15 UTC.", "orbit": "Low Earth Orbit", "image_url": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/tiangong25201_image_20190215013038.jpeg" }, "docking": "2012-06-24T04:38:00Z", "departure": "2012-06-28T01:22:00Z", "docking_location": { "id": 34, "name": "Tiangong-1 forward" } } ] } }, "mission": { "id": 259, "launch_library_id": 354, "name": "Shenzhou-9 & Shenzhou-9-GC", "description": "This is the fourth crewed mission for China's Shenzhou program which lasted 12 days. Being the first crewed spacecraft to visit the Tiangong-1 space station, it brought up the astronauts Jing Haipeng, Liu Wang and the first Chinese female astronaut Lie Yang. They docked automatically to the station on 18 June. During their stay in the station, astronauts conducted various scientific and technological experiments, and performed manual re-docking on 24 June. Shenzhou 9 undocked on 29 June and landed safely back on Earth the same day.", "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": 0, "title": "Shenzhou 9 launch, China rocket, June 16, 2012", "description": "WIKIPEDIA: The Shenzhou 9 spacecraft arrived at Jiuquan Satellite Launch Centre on April 9, 2012[1] and its launch rocket arrived on May 9. On June 9, 2012, ...", "feature_image": "https://i.ytimg.com/vi/cR7wR0aUpuE/hqdefault.jpg", "url": "https://www.youtube.com/watch?v=cR7wR0aUpuE" } ], "webcast_live": false, "image": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/long_march_2_image_20210908195835.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" } ], "orbital_launch_attempt_count": 5214, "location_launch_attempt_count": 59, "pad_launch_attempt_count": 10, "agency_launch_attempt_count": 111, "orbital_launch_attempt_count_year": 34, "location_launch_attempt_count_year": 2, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 10 }
