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/c6f8b6b0-6bae-460a-99bb-c12a3d29effd/?format=api
{ "id": "c6f8b6b0-6bae-460a-99bb-c12a3d29effd", "url": "https://ll.thespacedevs.com/2.2.0/launch/c6f8b6b0-6bae-460a-99bb-c12a3d29effd/?format=api", "slug": "ceres-1s-unknown-payload", "flightclub_url": null, "r_spacex_api_id": null, "name": "Ceres-1S | Unknown Payload", "status": { "id": 1, "name": "Go for Launch", "abbrev": "Go", "description": "Current T-0 confirmed by official or reliable sources." }, "last_updated": "2026-10-15T21:06:22Z", "updates": [ { "id": 16501, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Added launch per NOTAMs; Payload identity uncertain, possibly the Xiguang-4 01 Earth observation satellite.", "info_url": "https://forum.nasaspaceflight.com/index.php?topic=57867.msg2832786#msg2832786", "created_by": "Cosmic_Penguin", "created_on": "2026-10-15T21:06:00Z" } ], "net": "2026-10-21T03:35:00Z", "net_precision": { "id": 2, "name": "Hour", "abbrev": "HR", "description": "The T-0 is accurate to the hour." }, "window_end": "2026-10-21T03:50:00Z", "window_start": "2026-10-21T03:29:00Z", "probability": null, "weather_concerns": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 1021, "url": "https://ll.thespacedevs.com/2.2.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": 25, "consecutive_successful_launches": 1, "successful_launches": 22, "failed_launches": 3, "pending_launches": 1, "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-prod.nyc3.digitaloceanspaces.com/media/images/galactic2520energy_logo_20201106095229.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/galactic_energy_image_20201106095228.jpeg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/galactic2520energy_nation_20230703094321.png" }, "rocket": { "id": 9276, "configuration": { "id": 500, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/500/?format=api", "name": "Ceres-1S", "active": true, "reusable": false, "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://ll.thespacedevs.com/2.2.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": 25, "consecutive_successful_launches": 1, "successful_launches": 22, "failed_launches": 3, "pending_launches": 1, "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-prod.nyc3.digitaloceanspaces.com/media/images/galactic2520energy_logo_20201106095229.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/galactic_energy_image_20201106095228.jpeg", "nation_url": "https://thespacedevs-prod.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_cost": null, "launch_mass": null, "leo_capacity": 350, "gto_capacity": null, "to_thrust": 598, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-prod.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": 6, "consecutive_successful_launches": 6, "successful_launches": 6, "failed_launches": 0, "pending_launches": 1, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 7876, "name": "Unknown Payload", "description": "Details TBD.", "launch_designator": null, "type": "Unknown", "orbit": { "id": 25, "name": "Unknown", "abbrev": "N/A" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 221, "url": "https://ll.thespacedevs.com/2.2.0/pad/221/?format=api", "agency_id": 88, "name": "Rizhao offshore launch location", "description": "", "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://ll.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-prod.nyc3.digitaloceanspaces.com/media/map_images/location_haiyang_oriental_spaceport_20251128181322.jpg", "timezone_name": "Asia/Shanghai", "total_launch_count": 28, "total_landing_count": 0 }, "country_code": "CHN", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_oriental_spaceport_mobile_launch_ship_20240529085416.jpg", "total_launch_count": 7, "orbital_launch_attempt_count": 7 }, "infoURLs": [], "vidURLs": [], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.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, "pad_turnaround": "P278DT7H25M", "mission_patches": [], "type": "detailed" }
