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/79556b71-ae2d-4cfe-b4e1-76e02359bc26/?format=api
{ "id": "79556b71-ae2d-4cfe-b4e1-76e02359bc26", "url": "https://lldev.thespacedevs.com/2.2.0/launch/79556b71-ae2d-4cfe-b4e1-76e02359bc26/?format=api", "slug": "long-march-11-shiyan-24c", "flightclub_url": null, "r_spacex_api_id": null, "name": "Long March 11 | Shiyan 24C", "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-03-05T17:38:34Z", "updates": [ { "id": 6088, "profile_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Added launch per NOTAMs; Payload and launch vehicle identities highly uncertain.", "info_url": "https://forum.nasaspaceflight.com/index.php?topic=60053.0", "created_by": "Cosmic_Penguin", "created_on": "2023-12-23T02:32:00Z" }, { "id": 6111, "profile_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Launch success.", "info_url": "https://m.weibo.cn/detail/4983137816284339", "created_by": "Cosmic_Penguin", "created_on": "2023-12-26T02:10:31Z" } ], "net": "2023-12-25T22:39:00Z", "net_precision": { "id": 1, "name": "Minute", "abbrev": "MIN", "description": "The T-0 is accurate to the minute." }, "window_end": "2023-12-25T23:05:00Z", "window_start": "2023-12-25T22:20:00Z", "probability": null, "weather_concerns": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 88, "url": "https://lldev.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": 587, "consecutive_successful_launches": 13, "successful_launches": 572, "failed_launches": 15, "pending_launches": 10, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 1, "attempted_landings": 1, "info_url": "https://english.spacechina.com/", "wiki_url": "https://en.wikipedia.org/wiki/China_Aerospace_Science_and_Technology_Corporation", "logo_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_logo_20220826093937.png", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_image_20191228094408.jpeg", "nation_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_nation_20230604193716.png" }, "rocket": { "id": 8151, "configuration": { "id": 47, "url": "https://lldev.thespacedevs.com/2.2.0/config/launcher/47/?format=api", "name": "Long March 11", "active": true, "reusable": false, "description": "", "family": "Long March", "full_name": "Long March 11", "manufacturer": { "id": 88, "url": "https://lldev.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": 587, "consecutive_successful_launches": 13, "successful_launches": 572, "failed_launches": 15, "pending_launches": 10, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 1, "attempted_landings": 1, "info_url": "https://english.spacechina.com/", "wiki_url": "https://en.wikipedia.org/wiki/China_Aerospace_Science_and_Technology_Corporation", "logo_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_logo_20220826093937.png", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_image_20191228094408.jpeg", "nation_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_nation_20230604193716.png" }, "program": [], "variant": "", "alias": "", "min_stage": 1, "max_stage": 4, "length": 20.0, "diameter": 2.0, "maiden_flight": "2015-09-25", "launch_cost": null, "launch_mass": 58, "leo_capacity": 500, "gto_capacity": 0, "to_thrust": 1177, "apogee": 200, "vehicle_range": null, "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/long2520march252011_image_20190222031217.jpeg", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Long_March_11", "total_launch_count": 18, "consecutive_successful_launches": 18, "successful_launches": 18, "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": 6712, "name": "Shiyan 24C", "description": "3 satellites of unknown testing purposes, officially referred as for \"orbital technology testing\".", "launch_designator": null, "type": "Government/Top Secret", "orbit": { "id": 17, "name": "Sun-Synchronous Orbit", "abbrev": "SSO" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 217, "url": "https://lldev.thespacedevs.com/2.2.0/pad/217/?format=api", "agency_id": 88, "name": "South China Sea (launch location 1)", "description": "", "info_url": null, "wiki_url": null, "map_url": "https://www.google.com/maps?q=21.283333,112.0", "latitude": "21.283333", "longitude": "112.0", "location": { "id": 185, "url": "https://lldev.thespacedevs.com/2.2.0/location/185/?format=api", "name": "Haiyang Oriental Spaceport", "country_code": "CHN", "description": "Chinese orbital launch vehicle launches supporting sea port located at Haiyang, Shandong Province, with dedicated piers and rocket/payload processing facilities for Chinese launch vehicles’ sea launches, and (as part of its expansion project) land based launch pads on artificial islands for various test vehicles and launch vehicles of private and government launch services providers.\r\n\r\nIn operation as a remote base of Taiyuan Satellite Launch Center since 2019.", "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/location_haiyang_oriental_spaceport_20251128181322.jpg", "timezone_name": "Asia/Shanghai", "total_launch_count": 25, "total_landing_count": 0 }, "country_code": "CHN", "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/pad_bo_run_jiu_zhou_mobile_launch_platform_20231206001303.jpg", "total_launch_count": 2, "orbital_launch_attempt_count": 2 }, "infoURLs": [], "vidURLs": [ { "priority": 10, "source": "youtube.com", "publisher": "SciNews", "title": "Long March-11 launches Shiyan-24C", "description": "A Long March-11 launch vehicle launched the Shiyan-24C mission from a sea-based platform off the coast of Yangjiang, Guangdong Province, China, on 25 Decembe...", "feature_image": "https://i.ytimg.com/vi/c9hARMwQEtw/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=c9hARMwQEtw", "type": { "id": 6, "name": "Recap" }, "language": { "id": 1, "name": "English", "code": "en" }, "start_time": "2023-12-26T06:26:56Z", "end_time": "2023-12-26T06:27:56Z" } ], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/long2520march_image_20231226095919.jpeg", "infographic": null, "program": [], "orbital_launch_attempt_count": 6583, "location_launch_attempt_count": 8, "pad_launch_attempt_count": 2, "agency_launch_attempt_count": 450, "orbital_launch_attempt_count_year": 215, "location_launch_attempt_count_year": 3, "pad_launch_attempt_count_year": 2, "agency_launch_attempt_count_year": 45, "pad_turnaround": "P20DT3H15M", "mission_patches": [ { "id": 961, "name": "CZ-11 | Shiyan 24C", "priority": 10, "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/mission_patch_images/cz-112520257c_mission_patch_20231226121308.png", "agency": { "id": 88, "url": "https://lldev.thespacedevs.com/2.2.0/agencies/88/?format=api", "name": "China Aerospace Science and Technology Corporation", "type": "Government" } } ], "type": "detailed" }
