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/d1bff2ea-c639-46f9-947d-c5b116dab514/?format=api
{ "id": "d1bff2ea-c639-46f9-947d-c5b116dab514", "url": "https://ll.thespacedevs.com/2.2.0/launch/d1bff2ea-c639-46f9-947d-c5b116dab514/?format=api", "slug": "long-march-7-yz-1a-development-flight-1", "flightclub_url": null, "r_spacex_api_id": null, "name": "Long March 7 / YZ-1A | Development Flight 1", "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-07-08T08:33:09Z", "updates": [], "net": "2016-06-25T12:00:07Z", "net_precision": null, "window_end": "2016-06-25T14:00:00Z", "window_start": "2016-06-25T12:00:00Z", "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": 523, "consecutive_successful_launches": 65, "successful_launches": 509, "failed_launches": 14, "pending_launches": 9, "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": 1938, "configuration": { "id": 109, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/109/?format=api", "name": "Long March 7", "active": true, "reusable": false, "description": "", "family": "Long March", "full_name": "Long March 7 YZ-1A", "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": 523, "consecutive_successful_launches": 65, "successful_launches": 509, "failed_launches": 14, "pending_launches": 9, "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": "YZ-1A", "alias": "", "min_stage": null, "max_stage": null, "length": null, "diameter": null, "maiden_flight": "2016-06-25", "launch_cost": null, "launch_mass": null, "leo_capacity": null, "gto_capacity": null, "to_thrust": null, "apogee": null, "vehicle_range": null, "image_url": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Long_March_7", "total_launch_count": 1, "consecutive_successful_launches": 1, "successful_launches": 1, "failed_launches": 0, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 92, "name": "Development Flight 1", "description": "Inaugural flight of the Long March 7 (LM-7 for export or CZ-7 within China) This mission will test the rocket itself and a smaller version of a future next generation manned capsule", "launch_designator": null, "type": "Government/Top Secret", "orbit": { "id": 8, "name": "Low Earth Orbit", "abbrev": "LEO" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 176, "url": "https://ll.thespacedevs.com/2.2.0/pad/176/?format=api", "agency_id": null, "name": "201", "description": "", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Wenchang_Spacecraft_Launch_Site", "map_url": "https://www.google.com/maps?q=19.618452,110.955356", "latitude": "19.618452", "longitude": "110.955356", "location": { "id": 8, "url": "https://ll.thespacedevs.com/2.2.0/location/8/?format=api", "name": "Wenchang Space Launch Site, People's Republic of China", "country_code": "CHN", "description": "The Wenchang Space Launch Site is a rocket launch site located in Wenchang on the island of Hainan, in China.\r\n\r\nFormally a suborbital test center, it currently serves as China's southernmost spaceport. The site was selected for its low latitude, 19° north of the equator, allowing for larger payloads to be launched. It is capable of launching the Long March 5, the heaviest Chinese rocket. Unlike launch facilities on the mainland, Wenchang uses its seaport for deliveries.", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_8_20200803142445.jpg", "timezone_name": "Asia/Shanghai", "total_launch_count": 38, "total_landing_count": 0 }, "country_code": "CHN", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_176_20200803143412.jpg", "total_launch_count": 22, "orbital_launch_attempt_count": 22 }, "infoURLs": [], "vidURLs": [ { "priority": 0, "source": null, "publisher": null, "title": "Long March 7 Maiden Flight - T - 1 minute to upper stage separation", "description": "Liftoff of one of China's next generation rocket - the Long March 7 - and the inaugural flight from the Wenchang Satellite Launch Center on June 25, 2016. Cr...", "feature_image": "https://i.ytimg.com/vi/alFgWFVKc04/hqdefault.jpg", "url": "https://www.youtube.com/watch?v=alFgWFVKc04", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 0, "source": null, "publisher": null, "title": "China's Long March-7 Succeeds in Maiden Flight", "description": "China's new generation carrier rocket, the Long March-7, has successfully completed its maiden flight on Saturday night. The launch started at 20:00 Beijing ...", "feature_image": "https://i.ytimg.com/vi/obJgZ8d9i68/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=obJgZ8d9i68", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 0, "source": null, "publisher": null, "title": "China successfully launches new generation rocket carrier", "description": "China successfully launched its new generation of carrier rockets, the Long March 7, at 8 PM (local time) on Saturday from the Wenchang Satellite Launch Cent...", "feature_image": "https://i.ytimg.com/vi/JukOLID9Xk0/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=JukOLID9Xk0", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 0, "source": null, "publisher": null, "title": "Launch of Chinese Long March 7 inaugural flight from Hainan", "description": "Launch of Chinese Long March 7 inaugural flight from Hainan June 25, 2016 at 8 am EDT", "feature_image": "https://i.ytimg.com/vi/tpeO5m7CNnk/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=tpeO5m7CNnk", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 0, "source": null, "publisher": null, "title": "2016-06-25 Maiden Flight of Long March 7 from Wenchang Space Launch Center", "description": "Get YouTube without the ads", "feature_image": "https://i.ytimg.com/vi/SthAvbaDhcA/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=SthAvbaDhcA", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 0, "source": null, "publisher": null, "title": "China's Long March 7 carrier rocket blasts off", "description": "China's Long March-7 carrier rocket blasted off from the Wenchang satellite launch center in southern Hainan Province on Saturday evening. The new generation...", "feature_image": "https://i.ytimg.com/vi/Vf10pkD_cU0/hqdefault.jpg", "url": "https://www.youtube.com/watch?v=Vf10pkD_cU0", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 0, "source": null, "publisher": null, "title": "Exclusive: China successfully launches new generation carrier rocket", "description": "China successfully launched its new generation of carrier rockets, the Long March 7, at 8 PM (local time) on Saturday from the Wenchang Satellite Launch Cent...", "feature_image": "https://i.ytimg.com/vi/BvAXRcX8DXw/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=BvAXRcX8DXw", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 0, "source": null, "publisher": null, "title": "Lift off of Long March 7 (CZ-7)", "description": "Lift off of Long March 7 (CZ-7)", "feature_image": "https://i.ytimg.com/vi/qOI6CQKVUCg/hqdefault.jpg", "url": "https://www.youtube.com/watch?v=qOI6CQKVUCg", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 0, "source": null, "publisher": null, "title": "360° panorama video: China launches new generation carrier rocket", "description": "Explore this 360°panorama video to experience the stunning launch of China’s new generation carrier rocket Long March-7. The carrier rocket blasted off at 8:...", "feature_image": "https://i.ytimg.com/vi/GujEJDwC2Ks/hqdefault.jpg", "url": "https://www.youtube.com/watch?v=GujEJDwC2Ks", "type": null, "language": null, "start_time": null, "end_time": null } ], "webcast_live": false, "timeline": [], "image": null, "infographic": null, "program": [], "orbital_launch_attempt_count": 5571, "location_launch_attempt_count": 1, "pad_launch_attempt_count": 1, "agency_launch_attempt_count": 176, "orbital_launch_attempt_count_year": 42, "location_launch_attempt_count_year": 1, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 8, "pad_turnaround": "P0D", "mission_patches": [], "type": "detailed" }
