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/5274f868-7211-475c-ac93-bed6d8a8af3c/?format=api
{ "id": "5274f868-7211-475c-ac93-bed6d8a8af3c", "url": "https://ll.thespacedevs.com/2.2.0/launch/5274f868-7211-475c-ac93-bed6d8a8af3c/?format=api", "slug": "long-march-2d-shijian-10", "flightclub_url": null, "r_spacex_api_id": null, "name": "Long March 2D | Shijian 10", "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-14T15:48:06Z", "updates": [], "net": "2016-04-05T17:38:04Z", "net_precision": null, "window_end": "2016-04-05T17:38:04Z", "window_start": "2016-04-05T17:38:04Z", "probability": -1, "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": 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": 1920, "configuration": { "id": 17, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/17/?format=api", "name": "Long March 2D", "active": true, "reusable": false, "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.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": 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": "2D", "alias": "", "min_stage": 1, "max_stage": 2, "length": 38.3, "diameter": 3.35, "maiden_flight": "1992-08-09", "launch_cost": "30000000", "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": 93, "consecutive_successful_launches": 61, "successful_launches": 92, "failed_launches": 1, "pending_launches": 1, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 117, "name": "Shijian-10", "description": "Shijian-10 is a retrievable satellite that will perform 19 experiments in low earth orbit over 15 days before returning to earth. The experiments onboard include the Soret Coefficient in Crude Oil (SCCO) experiments, as well as experiments on radiation, combustion, and biology. Due to the short lifespan and retrievable design the craft will not be encapsulated within a fairing and will be powered by chemical batteries instead of solar panels.", "launch_designator": null, "type": "Earth Science", "orbit": { "id": 8, "name": "Low Earth Orbit", "abbrev": "LEO" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 22, "url": "https://ll.thespacedevs.com/2.2.0/pad/22/?format=api", "agency_id": null, "name": "Launch Area 4 (SLS-2 / 603)", "description": "", "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.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": 251, "total_landing_count": 0 }, "country_code": "CHN", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_22_20200803143437.jpg", "total_launch_count": 124, "orbital_launch_attempt_count": 124 }, "infoURLs": [], "vidURLs": [ { "priority": 0, "source": null, "publisher": null, "title": "[China News Daily] 20160406 | CCTV-4", "description": "[中国新闻]实践十号科学实验卫星发射成功 | CCTV-4 订阅CCTV YouTube官方频道 / Subscribe to our Official channels： CCTV中文国际: http://goo.gl/HcZaeZ CCTV春晚: http://goo.gl/A9V00o CCTV: http...", "feature_image": "https://i.ytimg.com/vi/DKNzD5PzPgo/hqdefault.jpg", "url": "https://www.youtube.com/watch?v=DKNzD5PzPgo", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 0, "source": null, "publisher": null, "title": "ShiJian-10 launch (实践十号/SJ-10)", "description": "A Long March 2D launch vehicle (Chang Zheng-2D) launched the Shijian-10 recoverable spacecraft on 05 April 2016, at 17:38:04 UTC (06 April 2016, at 01:38:04 ...", "feature_image": "https://i.ytimg.com/vi/Uao4O4NCfKM/hqdefault.jpg", "url": "https://www.youtube.com/watch?v=Uao4O4NCfKM", "type": null, "language": null, "start_time": null, "end_time": null } ], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/long2520march25202d_image_20190222031211.jpeg", "infographic": null, "program": [], "orbital_launch_attempt_count": 5552, "location_launch_attempt_count": 83, "pad_launch_attempt_count": 41, "agency_launch_attempt_count": 172, "orbital_launch_attempt_count_year": 23, "location_launch_attempt_count_year": 1, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 4, "pad_turnaround": "P110DT17H26M", "mission_patches": [], "type": "detailed" }
