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/c6f8b6b0-6bae-460a-99bb-c12a3d29effd/?format=api
{ "id": "c6f8b6b0-6bae-460a-99bb-c12a3d29effd", "url": "https://lldev.thespacedevs.com/2.0.0/launch/c6f8b6b0-6bae-460a-99bb-c12a3d29effd/?format=api", "launch_library_id": null, "slug": "ceres-1s-xiguang-4-01", "name": "Ceres-1S | Xiguang-4 01", "status": { "id": 3, "name": "Success" }, "net": "2026-10-21T03:39:00Z", "window_end": "2026-10-21T03:50:00Z", "window_start": "2026-10-21T03:29:00Z", "inhold": false, "tbdtime": false, "tbddate": false, "probability": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 1021, "url": "https://lldev.thespacedevs.com/2.0.0/agencies/1021/?format=api", "name": "Galactic Energy", "featured": false, "type": "Commercial", "country_code": "CHN", "abbrev": "GE", "description": "Galactic Energy is a private aerospace company headquartered in Beijing, China. Established by senior engineers in 2018, Galactic Energy engages in low-cost commercial space launch business.", "administrator": null, "founding_year": "2018", "launchers": "Ceres-1 | Pallas-1", "spacecraft": "", "launch_library_url": null, "total_launch_count": 26, "consecutive_successful_launches": 2, "successful_launches": 23, "failed_launches": 3, "pending_launches": 0, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://www.galactic-energy.cn/index.php/En", "wiki_url": null, "logo_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/galactic2520energy_logo_20201106095229.png", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/galactic_energy_image_20201106095228.jpeg", "nation_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/galactic2520energy_nation_20230703094321.png" }, "rocket": { "id": 9276, "configuration": { "id": 500, "launch_library_id": null, "url": "https://lldev.thespacedevs.com/2.0.0/config/launcher/500/?format=api", "name": "Ceres-1S", "description": "Ceres-1S is the sea launched version of Ceres-1 from Galactic Energy.", "family": "Ceres-1", "full_name": "Ceres-1S", "manufacturer": { "id": 1021, "url": "https://lldev.thespacedevs.com/2.0.0/agencies/1021/?format=api", "name": "Galactic Energy", "featured": false, "type": "Commercial", "country_code": "CHN", "abbrev": "GE", "description": "Galactic Energy is a private aerospace company headquartered in Beijing, China. Established by senior engineers in 2018, Galactic Energy engages in low-cost commercial space launch business.", "administrator": null, "founding_year": "2018", "launchers": "Ceres-1 | Pallas-1", "spacecraft": "", "launch_library_url": null, "total_launch_count": 26, "consecutive_successful_launches": 2, "successful_launches": 23, "failed_launches": 3, "pending_launches": 0, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://www.galactic-energy.cn/index.php/En", "wiki_url": null, "logo_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/galactic2520energy_logo_20201106095229.png", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/galactic_energy_image_20201106095228.jpeg", "nation_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/galactic2520energy_nation_20230703094321.png" }, "program": [], "variant": "Ceres-1S", "alias": "", "min_stage": 3, "max_stage": 4, "length": null, "diameter": null, "maiden_flight": "2023-09-05", "launch_mass": null, "leo_capacity": 350, "gto_capacity": null, "to_thrust": 598, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/ceres-1s_image_20230905114324.jpeg", "info_url": "http://www.galactic-energy.cn/index.php/En/List/cid/14", "wiki_url": null, "total_launch_count": 7, "consecutive_successful_launches": 7, "successful_launches": 7, "failed_launches": 0, "pending_launches": 0 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 7876, "launch_library_id": null, "name": "Xiguang-4 01", "description": "0.5 meter resolution Earth observation satellite for the city of Guangzhou government and Guangzhou University with multi-spectral imaging capability. Prototype of a proposed 25 satellites constellation.", "launch_designator": null, "type": "Earth Science", "orbit": { "id": 8, "name": "Low Earth Orbit", "abbrev": "LEO" } }, "pad": { "id": 221, "url": "https://lldev.thespacedevs.com/2.0.0/pad/221/?format=api", "agency_id": 88, "name": "Rizhao offshore launch location", "info_url": null, "wiki_url": null, "map_url": "https://www.google.com/maps?q=35.391667,119.598667", "latitude": "35.391667", "longitude": "119.598667", "location": { "id": 185, "url": "https://lldev.thespacedevs.com/2.0.0/location/185/?format=api", "name": "Haiyang Oriental Spaceport", "country_code": "CHN", "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/location_haiyang_oriental_spaceport_20251128181322.jpg", "total_launch_count": 29, "total_landing_count": 0 }, "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/pad_oriental_spaceport_mobile_launch_ship_20240529085416.jpg", "total_launch_count": 8 }, "infoURLs": [], "vidURLs": [ { "priority": 10, "title": "Live: Ceres-1S Flight 7 Launch (No Commentary)", "description": "Footage courtesy of 生活帮/JBYonion/日照润泽民宿/御道日照（逐光者）/三号门山海旅拍\n\n\nInternational Rocket Launches provides commentary-free coverage of select global rocket launches.\n\nFollow @IntRocketLaunch on Twitter: https://twitter.com/IntRocketLaunch\n\nRestreaming and reuse are permitted with credit to both the original source and @IntRocketLaunch.", "feature_image": "https://i.ytimg.com/vi/KvRfNtJocuo/maxresdefault_live.jpg", "url": "https://www.youtube.com/watch?v=KvRfNtJocuo" }, { "priority": 11, "title": "Watch Ceres-1S Launch from Haiyang, LIVE!!", "description": "Credits: TSDG Haiyang / WeChat sources (mirrored)\n-------------------------------------------------------------\nSubscribe and follow my socials for more content!!!\n▶️ Twitter/X @TestAiden [ThatSpaceDogeGuy]\n▶️ Instagram | ThatSpaceDogeGuy\n▶️ Tiktok | ThatSpaceDogeGuy\n▶️ Twitch | ThatSpaceDogeGuy\n\nFootage from TSDG may be reused only with proper credit. Credit must be clearly visible in the video or included in the description. Unauthorized use without credit may be subject to removal.\n\nFor all business inquiries, questions, or copyright matters, please contact: [email protected]", "feature_image": "https://i.ytimg.com/vi/74J2gr_yRHE/maxresdefault_live.jpg", "url": "https://www.youtube.com/watch?v=74J2gr_yRHE" } ], "webcast_live": false, "image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/ceres-1s_image_20230905114324.jpeg", "infographic": null, "program": [], "orbital_launch_attempt_count": 7419, "location_launch_attempt_count": 29, "pad_launch_attempt_count": 8, "agency_launch_attempt_count": 26, "orbital_launch_attempt_count_year": 246, "location_launch_attempt_count_year": 8, "pad_launch_attempt_count_year": 2, "agency_launch_attempt_count_year": 4 }
