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/ddb56894-06af-4cf5-b4c3-d0cf6e97ccf2/?format=api
{ "id": "ddb56894-06af-4cf5-b4c3-d0cf6e97ccf2", "url": "https://ll.thespacedevs.com/2.2.0/launch/ddb56894-06af-4cf5-b4c3-d0cf6e97ccf2/?format=api", "slug": "long-march-4c-gaofen-5", "flightclub_url": null, "r_spacex_api_id": null, "name": "Long March 4C | Gaofen 5", "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-06-15T13:22:31Z", "updates": [], "net": "2018-05-08T18:28:40Z", "net_precision": { "id": 0, "name": "Second", "abbrev": "SEC", "description": "The T-0 is accurate to the second." }, "window_end": "2018-05-08T18:46:00Z", "window_start": "2018-05-08T18:20: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": 2101, "configuration": { "id": 64, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/64/?format=api", "name": "Long March 4C", "active": true, "reusable": false, "description": "The Long March 4C, also known as the Chang Zheng 4C, CZ-4C and LM-4C, previously designated Long March 4B-II, is a Chinese orbital carrier rocket. It is launched from the Jiuquan, Taiyuan Satellite Launch Centre and Xichangs, and consists of 3 stages. Long March 4C vehicles have been used to launch the Yaogan-1, Yaogan-3 SAR satellites and the Fengyun-3A polar orbiting meteorological satellite. On December 15, 2009 a Long March 4C was used to launch Yaogan 8.", "family": "Long March", "full_name": "Long March 4C", "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": "C", "alias": "", "min_stage": 3, "max_stage": 3, "length": null, "diameter": null, "maiden_flight": "2006-04-26", "launch_cost": null, "launch_mass": null, "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_4c_image_20230801172338.jpeg", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Long_March_4C", "total_launch_count": 56, "consecutive_successful_launches": 30, "successful_launches": 54, "failed_launches": 2, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 933, "name": "Gaofen 5", "description": "Gaofen is a series of civilian Earth observation satellites developed and launched for the China High-definition Earth Observation System (CHEOS), a state-sponsored programme aimed to develop a near-real time, all-weather, global surveillance network consisting of satellite, near-space (stratosphere) airships, and aerial observation platforms.\nBased on the SAST5000B bus, Gaofen 5 will carry six types of payloads, including visible and short-wave infra hyper-spectral camera, spectral imager, greenhouse gas detector, atmospheric environment infrared detector at very high spectral resolution, differential absorption spectrometer for atmospheric trace gas, and multi-angle polarization detector. The satellite has a designed life of 8 years. It is to be launched atop of a Long March 4C to a 705km Sun Syncronous Orbit (SSO).", "launch_designator": null, "type": "Earth Science", "orbit": { "id": 17, "name": "Sun-Synchronous Orbit", "abbrev": "SSO" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 25, "url": "https://ll.thespacedevs.com/2.2.0/pad/25/?format=api", "agency_id": null, "name": "Launch Complex 9", "description": "", "info_url": null, "wiki_url": null, "map_url": "https://www.google.com/maps?q=38.863128,111.589567", "latitude": "38.863128", "longitude": "111.589567", "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_25_20200803143501.jpg", "total_launch_count": 76, "orbital_launch_attempt_count": 76 }, "infoURLs": [], "vidURLs": [ { "priority": 0, "source": null, "publisher": null, "title": "Gaofen-5 launched by Long March-4C", "description": "A Long March-4C launch vehicle launched the Gaofen-5 satellite from the Taiyuan Satellite Launch Center in Shanxi Province, north China, on 8 May 2018, at 18...", "feature_image": "https://i.ytimg.com/vi/l640DOJlMqs/hqdefault.jpg", "url": "https://www.youtube.com/watch?v=l640DOJlMqs", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 0, "source": null, "publisher": null, "title": "China launches world's first full spectrum hyperspectral satellite for environmental monitoring", "description": "China launched the world's first full-spectrum hyperspectral satellite Gaofen-5 for comprehensive observation of the atmosphere and land on May 9, at Taiyuan...", "feature_image": "https://i.ytimg.com/vi/AgYhHaNcjPc/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=AgYhHaNcjPc", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 0, "source": null, "publisher": null, "title": "China Launches First China-made Satellite for Monitoring Environment", "description": "China on Wednesday launched a hyperspectral imaging satellite, Gaofen-5, as part of the country's high-resolution Earth observation project. Gaofen-5 was lau...", "feature_image": "https://i.ytimg.com/vi/sUwEdkJmVJ8/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=sUwEdkJmVJ8", "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_4c_image_20230801172338.jpeg", "infographic": null, "program": [], "orbital_launch_attempt_count": 5749, "location_launch_attempt_count": 69, "pad_launch_attempt_count": 33, "agency_launch_attempt_count": 221, "orbital_launch_attempt_count_year": 43, "location_launch_attempt_count_year": 3, "pad_launch_attempt_count_year": 3, "agency_launch_attempt_count_year": 14, "pad_turnaround": "P38DT15H6M32S", "mission_patches": [], "type": "detailed" }
