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/54f5b72b-8353-4279-abb0-4a22385a606f/?format=api
{ "id": "54f5b72b-8353-4279-abb0-4a22385a606f", "url": "https://ll.thespacedevs.com/2.2.0/launch/54f5b72b-8353-4279-abb0-4a22385a606f/?format=api", "slug": "long-march-3be-change-4-lander-and-rover", "flightclub_url": null, "r_spacex_api_id": null, "name": "Long March 3B/E | Chang'e 4 (lander and rover)", "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:13:16Z", "updates": [], "net": "2018-12-07T18:23:34Z", "net_precision": null, "window_end": "2018-12-07T18:34:00Z", "window_start": "2018-12-07T18:15: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": 524, "consecutive_successful_launches": 66, "successful_launches": 510, "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": 38, "configuration": { "id": 50, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/50/?format=api", "name": "Long March 3", "active": true, "reusable": false, "description": "The Long March 3B / E (G2) (CZ-3B / E) is one of the most successful medium-range launchers and the strongest variant of the CZ-3 series.\r\nIt was specially developed for the transport of heavy communications satellites into a geostationary transfer orbit.\r\n\r\nThe additional designation \"E\" stands for a higher payload fairing, stretched boosters and extended fuel tanks at the first stage, over the CZ-3B.", "family": "Long March", "full_name": "Long March 3B/E", "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": 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": "B/E", "alias": "CZ-3B/E", "min_stage": 3, "max_stage": 3, "length": 56.3, "diameter": 3.35, "maiden_flight": "2007-05-13", "launch_cost": "70000000", "launch_mass": 456, "leo_capacity": 12000, "gto_capacity": 5500, "to_thrust": 5924, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/long2520march25203_image_20190222031215.jpeg", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Long_March_3B", "total_launch_count": 69, "consecutive_successful_launches": 46, "successful_launches": 68, "failed_launches": 1, "pending_launches": 2, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 755, "name": "Chang'e 4 (lander and rover)", "description": "Chang'e 4 is a Chinese lunar exploration mission, incorporating a robotic lander and rover. Chang'e 4 will be China's second lunar lander and rover. The spacecraft is named after the Chinese Moon goddess. This will be the first mission to attempt soft landing on the far side of the Moon.", "launch_designator": null, "type": "Robotic Exploration", "orbit": { "id": 11, "name": "Lunar Orbit", "abbrev": "LO" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 45, "url": "https://ll.thespacedevs.com/2.2.0/pad/45/?format=api", "agency_id": null, "name": "Launch Complex 2 (LC-2)", "description": "", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Xichang_Satellite_Launch_Center", "map_url": "https://www.google.com/maps?q=28.245564,102.026751", "latitude": "28.245564", "longitude": "102.026751", "location": { "id": 16, "url": "https://ll.thespacedevs.com/2.2.0/location/16/?format=api", "name": "Xichang Satellite Launch Center, People's Republic of China", "country_code": "CHN", "description": "The Xichang Satellite Launch Center is a spaceport in China. It is located in Zeyuan Town, northwest of Xichang, Liangshan Yi Autonomous Prefecture in Sichuan.", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_16_20200803142513.jpg", "timezone_name": "Asia/Shanghai", "total_launch_count": 225, "total_landing_count": 0 }, "country_code": "CHN", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_45_20200803143520.jpg", "total_launch_count": 118, "orbital_launch_attempt_count": 118 }, "infoURLs": [], "vidURLs": [ { "priority": 0, "source": null, "publisher": null, "title": "StarParty大众科学项目直播_科普直播_斗鱼直播", "description": "欢迎来到主播StarParty大众科学项目的斗鱼1963680科普直播间,本直播间提供最精彩的StarParty大众科学项目科普直播,StarParty大众科学项目带你领略最有趣的科普视频直播。", "feature_image": null, "url": "https://www.douyu.com/1963680", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 0, "source": null, "publisher": null, "title": "Chang’e-4 launch", "description": "A Long March-3B rocket launched China’s Chang’e-4 lunar mission from the Xichang Satellite Launch Center, Sichuan Province, southwest China, on 7 December 20...", "feature_image": "https://i.ytimg.com/vi/4RggZDYsPEo/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=4RggZDYsPEo", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 0, "source": null, "publisher": null, "title": "China launches Chang'e-4, in attempt to be first in landing on far side of the Moon", "description": "China successfully launched the Chang'e-4 lunar probe aboard a Long March 3B rocket at 2:23 a.m. BJT on December 8. With a lander and rover, its key mission ...", "feature_image": "https://i.ytimg.com/vi/pxU75SDWy1s/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=pxU75SDWy1s", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 0, "source": null, "publisher": null, "title": "Sina Visitor System", "description": "", "feature_image": null, "url": "https://www.weibo.com/tv/v/H6cXzndoB?fid=1034:4314797815077623", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 0, "source": null, "publisher": null, "title": "Sina Visitor System", "description": "", "feature_image": null, "url": "https://weibo.com/6528178851/H6iRDzAfH", "type": null, "language": null, "start_time": null, "end_time": null } ], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/long2520march25203_image_20190222031215.jpeg", "infographic": null, "program": [ { "id": 18, "url": "https://ll.thespacedevs.com/2.2.0/program/18/?format=api", "name": "Chinese Lunar Exploration Program", "description": "The Chinese Lunar Exploration Program also known as the Chang'e Project after the Chinese moon goddess Chang'e, is an ongoing series of robotic Moon missions by the China National Space Administration (CNSA). The program incorporates lunar orbiters, landers, rovers and sample return spacecraft, launched using Long March rockets.", "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/chinese2520lun_program_20201129190923.png", "start_date": "2003-01-01T00:00:00Z", "end_date": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Chinese_Lunar_Exploration_Program", "mission_patches": [], "type": { "id": 5, "name": "Exploration" } } ], "orbital_launch_attempt_count": 5811, "location_launch_attempt_count": 124, "pad_launch_attempt_count": 75, "agency_launch_attempt_count": 241, "orbital_launch_attempt_count_year": 105, "location_launch_attempt_count_year": 16, "pad_launch_attempt_count_year": 7, "agency_launch_attempt_count_year": 34, "pad_turnaround": "P36DT2H26M23S", "mission_patches": [], "type": "detailed" }
