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/a28fd245-9c3a-45ad-bf3a-b100d5af7ea0/?format=api
{ "id": "a28fd245-9c3a-45ad-bf3a-b100d5af7ea0", "url": "https://ll.thespacedevs.com/2.2.0/launch/a28fd245-9c3a-45ad-bf3a-b100d5af7ea0/?format=api", "slug": "long-march-2fg-tiangong-2", "flightclub_url": null, "r_spacex_api_id": null, "name": "Long March 2F/G | Tiangong-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": "2023-06-14T15:48:19Z", "updates": [], "net": "2016-09-15T14:04:09Z", "net_precision": null, "window_end": "2016-09-15T14:19:00Z", "window_start": "2016-09-15T14:04:00Z", "probability": -1, "weather_concerns": null, "holdreason": "", "failreason": null, "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": 524, "consecutive_successful_launches": 66, "successful_launches": 510, "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": 1954, "configuration": { "id": 84, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/84/?format=api", "name": "Long March 2", "active": true, "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/G", "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": 524, "consecutive_successful_launches": 66, "successful_launches": 510, "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": [], "variant": "F/G", "alias": "", "min_stage": 2, "max_stage": 2, "length": 62.0, "diameter": 3.35, "maiden_flight": "2011-10-31", "launch_cost": null, "launch_mass": 464, "leo_capacity": 8399, "gto_capacity": null, "to_thrust": null, "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/G", "total_launch_count": 18, "consecutive_successful_launches": 18, "successful_launches": 18, "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": 253, "name": "Tiangong-2", "description": "China's second space station, Tiangong-2 is tasked to verify key technologies such as cargo transportation, on-orbit propellant resupply, and a medium-term stay of astronauts. It will also carry an array of scientific experiments, and will be equipped with a robotic arm to help the assembly and maintenance of the station.", "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": 251, "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": 25, "orbital_launch_attempt_count": 25 }, "infoURLs": [ { "priority": 0, "source": null, "title": "国家航天局", "description": "", "feature_image": null, "url": "http://www.chinaspaceflight.com/css/Tiangong-2/Tiangong2-launch.html", "type": null, "language": null } ], "vidURLs": [ { "priority": 0, "source": null, "publisher": null, "title": "CCTV Reporter Shoots Tiangong-2 Launch 100 Meters Away", "description": "China has launched its Tiangong-2 space lab from the Jiuquan Satellite Launch Center in northwest China on Thursday at 22:04 local time. The footage was shot...", "feature_image": "https://i.ytimg.com/vi/xpMO7mgTPPQ/hqdefault.jpg", "url": "https://www.youtube.com/watch?v=xpMO7mgTPPQ", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 0, "source": null, "publisher": null, "title": "Up close! GoPro video of China's launch of space lab", "description": "This GoPro video offers you a front-seat view of the blast-off of the rocket carrying China's second experimental space laboratory. The Long March-2F T2 rock...", "feature_image": "https://i.ytimg.com/vi/MsJI7jnQsAg/hqdefault.jpg", "url": "https://www.youtube.com/watch?v=MsJI7jnQsAg", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 0, "source": null, "publisher": null, "title": "China successfully launches Tiangong2 space lab from Jiuquan Satellite Launch Center", "description": "China on Thursday launched space lab Tiangong-2 into space, paving the way for a permanent space station China plans to build around 2022. In a cloud of brow...", "feature_image": "https://i.ytimg.com/vi/7TPx9jYVQ0I/hqdefault.jpg", "url": "https://www.youtube.com/watch?v=7TPx9jYVQ0I", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 0, "source": null, "publisher": null, "title": "China successfully launches Tiangong-2 space lab", "description": "China has announced late on Thursday that the launch of its space lab Tiangong-2 was successful. A Long March-2F T2 carrier rocket, loaded with the Tiangong-...", "feature_image": "https://i.ytimg.com/vi/goRzJM4PIEI/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=goRzJM4PIEI", "type": null, "language": null, "start_time": null, "end_time": null } ], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/long_march_2_image_20210908195835.jpeg", "infographic": null, "program": [], "orbital_launch_attempt_count": 5588, "location_launch_attempt_count": 87, "pad_launch_attempt_count": 12, "agency_launch_attempt_count": 182, "orbital_launch_attempt_count_year": 59, "location_launch_attempt_count_year": 5, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 14, "pad_turnaround": "P1192DT4H26M7S", "mission_patches": [], "type": "detailed" }
