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/fa1ef649-5c4d-42d2-a5e9-1252dc0469f3/?format=api
{ "id": "fa1ef649-5c4d-42d2-a5e9-1252dc0469f3", "url": "https://ll.thespacedevs.com/2.2.0/launch/fa1ef649-5c4d-42d2-a5e9-1252dc0469f3/?format=api", "slug": "long-march-11-tianping-2-abc", "flightclub_url": null, "r_spacex_api_id": null, "name": "Long March 11 | Tianping-2 A/B/C", "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-10-22T01:01:47Z", "updates": [ { "id": 1479, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Launch success", "info_url": "https://weibo.com/6528178851/Lm6f6Dq0l", "created_by": "Cosmic_Penguin", "created_on": "2022-03-30T03:08:58Z" }, { "id": 1473, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "New launch date", "info_url": "https://forum.nasaspaceflight.com/index.php?topic=56013.msg2354440#msg2354440", "created_by": "Cosmic_Penguin", "created_on": "2022-03-28T08:06:07Z" }, { "id": 1471, "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=56013.0", "created_by": "Cosmic_Penguin", "created_on": "2022-03-26T16:34:27Z" } ], "net": "2022-03-30T02:29:00Z", "net_precision": null, "window_end": "2022-03-30T02:50:00Z", "window_start": "2022-03-30T02:18: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": 7473, "configuration": { "id": 47, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/47/?format=api", "name": "Long March 11", "active": true, "reusable": false, "description": "", "family": "Long March", "full_name": "Long March 11", "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": "11", "alias": "", "min_stage": 1, "max_stage": 4, "length": 20.0, "diameter": 2.0, "maiden_flight": "2015-09-25", "launch_cost": null, "launch_mass": 58, "leo_capacity": 500, "gto_capacity": 0, "to_thrust": 1177, "apogee": 200, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/long2520march252011_image_20190222031217.jpeg", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Long_March_11", "total_launch_count": 17, "consecutive_successful_launches": 17, "successful_launches": 17, "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": 6973, "name": "Tianping-2 A/B/C", "description": "The Tianping-2 A/B/C satellites were built by the China Aerospace Science and Industry Corporation (CASIC) and will be used as calibration targets for services such as atmospheric space environment study and orbital prediction model correction.", "launch_designator": null, "type": "Technology", "orbit": { "id": 17, "name": "Sun-Synchronous Orbit", "abbrev": "SSO" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 21, "url": "https://ll.thespacedevs.com/2.2.0/pad/21/?format=api", "agency_id": null, "name": "Launch Area 95A", "description": "", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Jiuquan_Satellite_Launch_Center", "map_url": "https://www.google.com/maps?q=40.969117,100.343333", "latitude": "40.969117", "longitude": "100.343333", "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": 248, "total_landing_count": 0 }, "country_code": "CHN", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_21_20200803143253.jpg", "total_launch_count": 59, "orbital_launch_attempt_count": 59 }, "infoURLs": [], "vidURLs": [], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/long2520march252011_image_20190222031217.jpeg", "infographic": null, "program": [], "orbital_launch_attempt_count": 6215, "location_launch_attempt_count": 161, "pad_launch_attempt_count": 29, "agency_launch_attempt_count": 360, "orbital_launch_attempt_count_year": 33, "location_launch_attempt_count_year": 4, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 8, "pad_turnaround": "P105DT29M", "mission_patches": [], "type": "detailed" }
