Launch Instance
API endpoint that returns all Launch objects or a single launch.
EXAMPLE - /launch/
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'
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.0.0/launch/1a899b5c-31f9-4aa8-baa9-4f88eb5d789e/?format=api
{ "id": "1a899b5c-31f9-4aa8-baa9-4f88eb5d789e", "url": "https://ll.thespacedevs.com/2.0.0/launch/1a899b5c-31f9-4aa8-baa9-4f88eb5d789e/?format=api", "launch_library_id": null, "slug": "long-march-2d-tianhui-1-04", "name": "Long March 2D | Tianhui-1-04", "status": { "id": 3, "name": "Success" }, "net": "2021-07-29T04:01:00Z", "window_end": "2021-07-29T04:21:00Z", "window_start": "2021-07-29T03:45:00Z", "inhold": false, "tbdtime": false, "tbddate": false, "probability": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 88, "url": "https://ll.thespacedevs.com/2.0.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": 557, "consecutive_successful_launches": 99, "successful_launches": 543, "failed_launches": 14, "pending_launches": 5, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://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": 2974, "configuration": { "id": 17, "launch_library_id": 73, "url": "https://ll.thespacedevs.com/2.0.0/config/launcher/17/?format=api", "name": "Long March 2D", "description": "The Long March 2D, also known as the Chang Zheng 2D, CZ-2D and LM-2D, is a Chinese orbital carrier rocket. It is a 2-stage carrier rocket mainly used for launching LEO and SSO satellites.", "family": "Long March", "full_name": "Long March 2D", "manufacturer": { "id": 88, "url": "https://ll.thespacedevs.com/2.0.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": 557, "consecutive_successful_launches": 99, "successful_launches": 543, "failed_launches": 14, "pending_launches": 5, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://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": "D", "alias": "", "min_stage": 1, "max_stage": 2, "length": 38.3, "diameter": 3.35, "maiden_flight": "1992-08-09", "launch_mass": 232, "leo_capacity": 3500, "gto_capacity": 0, "to_thrust": 2962, "apogee": 500, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/long2520march25202d_image_20190222031211.jpeg", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Long_March_(rocket_family)", "total_launch_count": 96, "consecutive_successful_launches": 64, "successful_launches": 95, "failed_launches": 1, "pending_launches": 0 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 1401, "launch_library_id": null, "name": "Tianhui-1-04", "description": "TH 1 (Tianhui-1 = \"Sky drawing\") is a Chinese stereo-topographic mapping satellite operated by the People’s Liberation Army (PLA).\r\n\r\nThe satellites are built by the Hangtian Dongfanghong Weixing Corporation and the China Aerospace Science and Technology Corporation and the Chinese Academy of Space Technology (CAST). The satellites operate on a 500 km circular sun synchronous orbit. Electrical power is provided by two deployable solar panels that is stored on onboard batteries.\r\n\r\nThey are equipped with a three-dimensional survey camera and a CCD camera with a ground resolution of 5 meters, spectral region of 0.51 µm to 0.69 µm and with a camera angle of 25 degrees. Also on board is a multi-spectral camera with a ground resolution of 10 meters operating in four spectral bands of 0.43 µm to 0.52 µm, 0.52 µm to 0.61 µm, 0.61 µm to 0.69 µm, and 0.76 µm to 0.90 µm. The swath width of the cameras is 60 kilometers wide.", "launch_designator": null, "type": "Earth Science", "orbit": { "id": 17, "name": "Sun-Synchronous Orbit", "abbrev": "SSO" } }, "pad": { "id": 22, "url": "https://ll.thespacedevs.com/2.0.0/pad/22/?format=api", "agency_id": null, "name": "Launch Area 4 (SLS-2 / 603)", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Jiuquan_Launch_Area_4", "map_url": "https://www.google.com/maps?q=40.960482,100.298059", "latitude": "40.960482", "longitude": "100.298059", "location": { "id": 17, "url": "https://ll.thespacedevs.com/2.0.0/location/17/?format=api", "name": "Jiuquan Satellite Launch Center, People's Republic of China", "country_code": "CHN", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_17_20200803142429.jpg", "total_launch_count": 266, "total_landing_count": 0 }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_22_20200803143437.jpg", "total_launch_count": 130 }, "infoURLs": [], "vidURLs": [ { "priority": 10, "title": "Long March-2D launches TianHui-1 04", "description": "A Long March-2D launch vehicle launched the TianHui-1 04 satellite from the Jiuquan Satellite Launch Center, Gansu Province, northwest China, on 29 July 2021, at 04:01 UTC (12:01 local time). TianHui-...", "feature_image": "https://i.ytimg.com/vi/2A_AGN_ee6Q/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=2A_AGN_ee6Q" } ], "webcast_live": false, "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/long2520march25202d_image_20190222031211.jpeg", "infographic": null, "program": [], "orbital_launch_attempt_count": 6107, "location_launch_attempt_count": 145, "pad_launch_attempt_count": 78, "agency_launch_attempt_count": 328, "orbital_launch_attempt_count_year": 70, "location_launch_attempt_count_year": 10, "pad_launch_attempt_count_year": 8, "agency_launch_attempt_count_year": 24 }