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/f9e39cde-55d5-4ee5-9bd9-dd855f55b3eb/?format=api
{ "id": "f9e39cde-55d5-4ee5-9bd9-dd855f55b3eb", "url": "https://ll.thespacedevs.com/2.2.0/launch/f9e39cde-55d5-4ee5-9bd9-dd855f55b3eb/?format=api", "slug": "long-march-6a-demo-flight-pujiang-2-tiankun-2", "flightclub_url": null, "r_spacex_api_id": null, "name": "Long March 6A | Demo Flight (Pujiang-2 & Tiankun-2)", "status": { "id": 3, "name": "Launch Successful", "abbrev": "Success", "description": "The launch vehicle successfully inserted its payload(s) into the target orbit(s)." }, "last_updated": "2024-03-05T18:17:47Z", "updates": [ { "id": 1477, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Launch successful", "info_url": "https://weibo.com/5386897742/LlZJKwgRf", "created_by": "Cosmic_Penguin", "created_on": "2022-03-29T10:29:45Z" }, { "id": 1474, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Updated per official photos that launch may be of the 1st LM-6A, however launch vehicle identity is still uncertain.", "info_url": "https://mp.weixin.qq.com/s/h1fjSHvTC7FOcryLtLZ_lg", "created_by": "Cosmic_Penguin", "created_on": "2022-03-28T15:03:46Z" }, { "id": 1472, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Added launch per NOTAMs; Payload and launch vehicle identity not known.", "info_url": "https://forum.nasaspaceflight.com/index.php?topic=56072.0", "created_by": "Cosmic_Penguin", "created_on": "2022-03-26T16:34:30Z" } ], "net": "2022-03-29T09:50:00Z", "net_precision": null, "window_end": "2022-03-29T10:20:00Z", "window_start": "2022-03-29T09:42:00Z", "probability": null, "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": 520, "consecutive_successful_launches": 62, "successful_launches": 506, "failed_launches": 14, "pending_launches": 11, "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": 7475, "configuration": { "id": 478, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/478/?format=api", "name": "Long March 6A", "active": true, "reusable": false, "description": "The Long March 6A is a Chinese launch vehicle of the Long March family, which was developed by the China Aerospace Science and Technology Corporation (CASC) and the Shanghai Academy of Spaceflight Technology (SAST). The vehicle is a further development of the Long March 6, with 2 YF-100 engines on the first stage as opposed to 1 on the Long March 6, augmented by 4 solid rocket boosters. The Long March 6A is China's first rocket with solid rocket boosters. The maiden launch of the Long March 6A took place 29 March 2022, successfully reaching orbit. It was also the first launch from the newly built launch complex 9A in Taiyuan.", "family": "Long March", "full_name": "Long March 6A", "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": 520, "consecutive_successful_launches": 62, "successful_launches": 506, "failed_launches": 14, "pending_launches": 11, "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": "", "alias": "", "min_stage": 1, "max_stage": 2, "length": 50.0, "diameter": 3.35, "maiden_flight": "2022-03-29", "launch_cost": null, "launch_mass": 530, "leo_capacity": null, "gto_capacity": null, "to_thrust": 7230, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/long_march_6a_image_20221109174525.png", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Long_March_6", "total_launch_count": 11, "consecutive_successful_launches": 11, "successful_launches": 11, "failed_launches": 0, "pending_launches": 1, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 6529, "name": "Demo Flight (Pujiang-2 & Tiankun-2)", "description": "First launch of the Long March 6A rocket.\r\n\r\nPujiang 2 is a Chinese technology demonstration satellite.\r\n\r\nTiankun-2 is a satellite developed by CASIC, which is a technology demonstration mission to test out their new small satellite bus.", "launch_designator": null, "type": "Test Flight", "orbit": { "id": 17, "name": "Sun-Synchronous Orbit", "abbrev": "SSO" }, "agencies": [ { "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": 520, "consecutive_successful_launches": 62, "successful_launches": 506, "failed_launches": 14, "pending_launches": 11, "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" } ], "info_urls": [], "vid_urls": [] }, "pad": { "id": 200, "url": "https://ll.thespacedevs.com/2.2.0/pad/200/?format=api", "agency_id": null, "name": "Launch Complex 9A", "description": "", "info_url": null, "wiki_url": null, "map_url": "https://www.google.com/maps?q=38.8583,111.5802", "latitude": "38.8583", "longitude": "111.5802", "location": { "id": 19, "url": "https://ll.thespacedevs.com/2.2.0/location/19/?format=api", "name": "Taiyuan Satellite Launch Center, People's Republic of China", "country_code": "CHN", "description": "The Taiyuan Satellite Launch Center is a People's Republic of China space and defense launch facility. It is situated in Kelan County, Xinzhou, Shanxi Province and is the second of four launch sites having been founded in March 1966 and coming into full operation in 1968.", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_19_20200803142421.jpg", "timezone_name": "Asia/Shanghai", "total_launch_count": 140, "total_landing_count": 0 }, "country_code": "CHN", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_launch_complex_9a_20220330003717.jpg", "total_launch_count": 12, "orbital_launch_attempt_count": 12 }, "infoURLs": [], "vidURLs": [ { "priority": 10, "source": "www.youtube.com", "publisher": null, "title": "The first launch of Long March-6A", "description": "The first Long March-6A launch vehicle launched two satellites, Tiankun-2 (天鲲二) & Pujiang-2 (浦江二), from the Taiyuan Satellite Launch Center, Shanxi Province,...", "feature_image": "https://i.ytimg.com/vi/4gMifyUj6a4/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=4gMifyUj6a4", "type": { "id": 1, "name": "Official Webcast" }, "language": { "id": 1, "name": "English", "code": "en" }, "start_time": null, "end_time": null } ], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/long2520march_image_20230905130411.jpeg", "infographic": null, "program": [], "orbital_launch_attempt_count": 6214, "location_launch_attempt_count": 103, "pad_launch_attempt_count": 1, "agency_launch_attempt_count": 359, "orbital_launch_attempt_count_year": 32, "location_launch_attempt_count_year": 2, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 7, "pad_turnaround": "P0D", "mission_patches": [ { "id": 875, "name": "CZ-6A | Y1", "priority": 10, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/mission_patch_images/cz-6a2520257c_mission_patch_20230905130408.png", "agency": { "id": 88, "url": "https://ll.thespacedevs.com/2.2.0/agencies/88/?format=api", "name": "China Aerospace Science and Technology Corporation", "type": "Government" } } ], "type": "detailed" }
