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/64c62222-f8f8-4a35-a8d7-e1b3a0a9250d/?format=api
{ "id": "64c62222-f8f8-4a35-a8d7-e1b3a0a9250d", "url": "https://ll.thespacedevs.com/2.2.0/launch/64c62222-f8f8-4a35-a8d7-e1b3a0a9250d/?format=api", "slug": "long-march-6-kl-beta", "flightclub_url": null, "r_spacex_api_id": null, "name": "Long March 6 | KL-Beta", "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-14T04:20:12Z", "updates": [ { "id": 705, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Added launch.", "info_url": "https://twitter.com/aj_fi/status/1422889285414494215?s=21", "created_by": "Cosmic_Penguin", "created_on": "2021-08-04T14:46:19Z" } ], "net": "2021-08-04T11:01:00Z", "net_precision": null, "window_end": "2021-08-04T12:00:00Z", "window_start": "2021-08-04T10:00: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": 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": 2979, "configuration": { "id": 54, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/54/?format=api", "name": "Long March 6", "active": true, "reusable": false, "description": "", "family": "Long March", "full_name": "Long March 6", "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": "", "alias": "", "min_stage": 1, "max_stage": 3, "length": 29.0, "diameter": 3.35, "maiden_flight": "2015-09-19", "launch_cost": null, "launch_mass": 103, "leo_capacity": null, "gto_capacity": null, "to_thrust": null, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/long_march_6_image_20210709074933.jpg", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Long_March_6", "total_launch_count": 14, "consecutive_successful_launches": 14, "successful_launches": 14, "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": 1404, "name": "KL-Beta", "description": "The KL-Beta A and B, satellites are test satellites for a global multimedia satellite system for the German company KLEO Connect and the Chinese company Shanghai Spacecom Satellite Technology.\r\n\r\nThe satellites were built by CAS Microspace and feature a Ka-band communications payload.\r\n\r\nThe prototype system also includes another satellite “GMS-T” built by OHB System of Germany.", "launch_designator": null, "type": "Communications", "orbit": { "id": 13, "name": "Polar Orbit", "abbrev": "PO" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 113, "url": "https://ll.thespacedevs.com/2.2.0/pad/113/?format=api", "agency_id": null, "name": "Launch Complex 16", "description": null, "info_url": null, "wiki_url": null, "map_url": "https://www.google.com/maps?q=38.868222,111.58024", "latitude": "38.868222", "longitude": "111.58024", "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": 141, "total_landing_count": 0 }, "country_code": "CHN", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_113_20200803143556.jpg", "total_launch_count": 15, "orbital_launch_attempt_count": 15 }, "infoURLs": [], "vidURLs": [ { "priority": 10, "source": null, "publisher": null, "title": "Long March-6 launches two KL-Beta satellites", "description": "A Long March-6 launch vehicle launched two satellites from the Taiyuan Satellite Launch Center, Shanxi Province, China, on 4 August 2021, at 11:01 UTC (19:01...", "feature_image": "https://i.ytimg.com/vi/zcAkB1IIlsE/hqdefault.jpg", "url": "https://www.youtube.com/watch?v=zcAkB1IIlsE", "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_6_image_20210709074933.jpg", "infographic": null, "program": [], "orbital_launch_attempt_count": 6111, "location_launch_attempt_count": 95, "pad_launch_attempt_count": 8, "agency_launch_attempt_count": 329, "orbital_launch_attempt_count_year": 74, "location_launch_attempt_count_year": 6, "pad_launch_attempt_count_year": 3, "agency_launch_attempt_count_year": 25, "pad_turnaround": "P25DT23H2M", "mission_patches": [], "type": "detailed" }
