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/c1415188-a462-48a4-8427-06101e5c1d29/?format=api
{ "id": "c1415188-a462-48a4-8427-06101e5c1d29", "url": "https://ll.thespacedevs.com/2.2.0/launch/c1415188-a462-48a4-8427-06101e5c1d29/?format=api", "slug": "long-march-3a-beidou-daohang-shiyan-wei-2", "flightclub_url": null, "r_spacex_api_id": null, "name": "Long March 3A | Beidou Daohang Shiyan Wei. 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-14T03:53:43Z", "updates": [], "net": "2000-12-20T16:20:00Z", "net_precision": null, "window_end": "2000-12-20T16:20:00Z", "window_start": "2000-12-20T16:20:00Z", "probability": null, "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": 7029, "configuration": { "id": 71, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/71/?format=api", "name": "Long March 3A", "active": true, "reusable": false, "description": "", "family": "Long March", "full_name": "Long March 3A", "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": "", "alias": "", "min_stage": 1, "max_stage": 3, "length": 52.5, "diameter": 3.35, "maiden_flight": "1994-02-08", "launch_cost": null, "launch_mass": 240, "leo_capacity": 0, "gto_capacity": 2300, "to_thrust": 2962, "apogee": 40000, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/long2520march25203a_image_20190222031143.png", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Long_March_3A", "total_launch_count": 27, "consecutive_successful_launches": 27, "successful_launches": 27, "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": 5418, "name": "Beidou Daohang Shiyan Wei. 2", "description": "The BD 1 (Beidou 1) satellites were the 1st phase of the chinese Beidou (Compass) satellite navigation system. The first phase uses only geostationary satellites, in contrast to GPS and GLONASS. This reduces the number of satellites, but limits the coverage to a less than hemispherical area. The basic constellation requires 3 satellites. The satellites are based on the DFH-3 Bus.", "launch_designator": null, "type": "Navigation", "orbit": { "id": 1, "name": "Geostationary Orbit", "abbrev": "Direct-GEO" }, "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": [], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/long2520march25203a_image_20190222031143.png", "infographic": null, "program": [ { "id": 35, "url": "https://ll.thespacedevs.com/2.2.0/program/35/?format=api", "name": "BeiDou", "description": "The BeiDou Navigation Satellite System is a satellite-based radio navigation system owned and operated by the China National Space Administration.[4] It is one of the global navigation satellite systems that provide geolocation and time information to a BDS receiver anywhere on or near the Earth where there is an unobstructed line of sight to four or more BDS satellites.", "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/beidou_program_20240102170615.png", "start_date": "2000-10-31T00:00:00Z", "end_date": null, "info_url": "http://en.beidou.gov.cn/", "wiki_url": "https://en.wikipedia.org/wiki/BeiDou", "mission_patches": [], "type": { "id": 4, "name": "Navigation Constellation" } } ], "orbital_launch_attempt_count": 4451, "location_launch_attempt_count": 31, "pad_launch_attempt_count": 18, "agency_launch_attempt_count": 7, "orbital_launch_attempt_count_year": 84, "location_launch_attempt_count_year": 4, "pad_launch_attempt_count_year": 3, "agency_launch_attempt_count_year": 5, "pad_turnaround": "P51DT18M", "mission_patches": [], "type": "detailed" }
