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/2f255496-16b0-4ae6-ac9e-8e24f5deae7a/?format=api
{ "id": "2f255496-16b0-4ae6-ac9e-8e24f5deae7a", "url": "https://ll.thespacedevs.com/2.2.0/launch/2f255496-16b0-4ae6-ac9e-8e24f5deae7a/?format=api", "slug": "ceres-1s-tianqi-21-24", "flightclub_url": null, "r_spacex_api_id": null, "name": "Ceres-1S | Tianqi 21-24", "status": { "id": 3, "name": "Launch Successful", "abbrev": "Success", "description": "The launch vehicle successfully inserted its payload(s) into the target orbit(s)." }, "last_updated": "2025-09-25T13:50:49Z", "updates": [ { "id": 5076, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Launch success.", "info_url": "https://m.weibo.cn/detail/4942672131785496", "created_by": "Cosmic_Penguin", "created_on": "2023-09-05T10:15:50Z" }, { "id": 5040, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Added launch time per NOTAMs.", "info_url": "https://forum.nasaspaceflight.com/index.php?topic=57867.msg2519733#msg2519733", "created_by": "Cosmic_Penguin", "created_on": "2023-09-01T06:38:08Z" }, { "id": 5075, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Liftoff", "info_url": "https://live.douyin.com/206403289521", "created_by": "Cosmic_Penguin", "created_on": "2023-09-05T09:35:41Z" }, { "id": 5074, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "New T-0.", "info_url": "https://live.douyin.com/206403289521", "created_by": "Cosmic_Penguin", "created_on": "2023-09-05T09:27:24Z" }, { "id": 5009, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Adding launch", "info_url": "https://twitter.com/CNSpaceflight/status/1694173152597918192", "created_by": "Nosu", "created_on": "2023-08-27T17:47:03Z" } ], "net": "2023-09-05T09:34:46Z", "net_precision": { "id": 0, "name": "Second", "abbrev": "SEC", "description": "The T-0 is accurate to the second." }, "window_end": "2023-09-05T10:02:00Z", "window_start": "2023-09-05T09:25: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": 22, "consecutive_successful_launches": 0, "successful_launches": 20, "failed_launches": 2, "pending_launches": 2, "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": 7995, "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": 22, "consecutive_successful_launches": 0, "successful_launches": 20, "failed_launches": 2, "pending_launches": 2, "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": 5, "consecutive_successful_launches": 5, "successful_launches": 5, "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": 6528, "name": "Tianqi 21-24", "description": "4 small satellites for LEO Internet of Things (IoT) communication purposes.", "launch_designator": null, "type": "Communications", "orbit": { "id": 8, "name": "Low Earth Orbit", "abbrev": "LEO" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 89, "url": "https://ll.thespacedevs.com/2.2.0/pad/89/?format=api", "agency_id": 88, "name": "DeFu-15002 mobile launch platform", "description": "", "info_url": null, "wiki_url": null, "map_url": "https://www.google.com/maps?q=36.631333,121.198361", "latitude": "36.631333", "longitude": "121.198361", "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": 21, "total_landing_count": 0 }, "country_code": "CHN", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_89_20200803143242.jpg", "total_launch_count": 2, "orbital_launch_attempt_count": 2 }, "infoURLs": [], "vidURLs": [ { "priority": 9, "source": "youtube.com", "publisher": "SciNews", "title": "Ceres-1S Y1 - the first sea launch of Ceres-1", "description": "The first Ceres-1S launch vehicle (Y1, “The Little Mermaid” mission) launched four Tianqi satellites (Tianqi-21 ~ 24/ 天启星座21~24) from a sea platform located near Haiyang, Shandong Province, China, on ...", "feature_image": "https://i.ytimg.com/vi/Ipz050Dzpl8/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=Ipz050Dzpl8", "type": { "id": 6, "name": "Recap" }, "language": { "id": 1, "name": "English", "code": "en" }, "start_time": "2023-09-05T12:02:53Z", "end_time": "2023-09-05T12:04:14Z" }, { "priority": 10, "source": "live.douyin.com", "publisher": "Live", "title": null, "description": "", "feature_image": null, "url": "https://live.douyin.com/206403289521", "type": { "id": 3, "name": "Unofficial Webcast" }, "language": { "id": 1, "name": "English", "code": "en" }, "start_time": null, "end_time": null } ], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/ceres-1s25202_image_20230905114300.jpeg", "infographic": null, "program": [], "orbital_launch_attempt_count": 6510, "location_launch_attempt_count": 6, "pad_launch_attempt_count": 2, "agency_launch_attempt_count": 9, "orbital_launch_attempt_count_year": 142, "location_launch_attempt_count_year": 1, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 5, "pad_turnaround": "P332DT20H24M17S", "mission_patches": [ { "id": 872, "name": "Ceres-1S Y1", "priority": 10, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/mission_patch_images/ceres-1s2520y1_mission_patch_20230831065135.png", "agency": { "id": 1021, "url": "https://ll.thespacedevs.com/2.2.0/agencies/1021/?format=api", "name": "Galactic Energy", "type": "Commercial" } } ], "type": "detailed" }
