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/ea2d97bc-a834-4904-b579-6a1e1f7a9c54/?format=api
{ "id": "ea2d97bc-a834-4904-b579-6a1e1f7a9c54", "url": "https://lldev.thespacedevs.com/2.2.0/launch/ea2d97bc-a834-4904-b579-6a1e1f7a9c54/?format=api", "slug": "ceres-1s-tianqi-37-40", "flightclub_url": null, "r_spacex_api_id": null, "name": "Ceres-1S | Tianqi 37-40", "status": { "id": 3, "name": "Launch Successful", "abbrev": "Success", "description": "The launch vehicle successfully inserted its payload(s) into the target orbit(s)." }, "last_updated": "2026-01-15T22:32:35Z", "updates": [ { "id": 13624, "profile_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Refined launch window per new NOTAMs.", "info_url": "https://forum.nasaspaceflight.com/index.php?topic=57867.msg2750526#msg2750526", "created_by": "Cosmic_Penguin", "created_on": "2026-01-13T17:43:00Z" }, { "id": 13658, "profile_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/profile_images/ll2_profile_20230311134739.png", "comment": "Unofficial Webcast by International Rocket Launches has started", "info_url": "https://www.youtube.com/watch?v=SLI3ImHOIgk", "created_by": "LL2", "created_on": "2026-01-15T19:05:00Z" }, { "id": 13659, "profile_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/profile_images/ll2_profile_20230311134739.png", "comment": "Unofficial Webcast by ThatSpaceDogeGuy has started", "info_url": "https://www.youtube.com/watch?v=YfYp6Zs6Diw", "created_by": "LL2", "created_on": "2026-01-15T19:46:00Z" }, { "id": 13660, "profile_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Liftoff.", "info_url": "https://www.youtube.com/watch?v=YfYp6Zs6Diw", "created_by": "Cosmic_Penguin", "created_on": "2026-01-15T20:17:00Z" }, { "id": 13661, "profile_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Launch success.", "info_url": "https://finance.sina.com.cn/7x24/2026-01-16/doc-inhhmthz7146567.shtml", "created_by": "Cosmic_Penguin", "created_on": "2026-01-15T20:54:00Z" }, { "id": 13572, "profile_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Added launch per NOTAMs; Payload identities uncertain.", "info_url": "https://forum.nasaspaceflight.com/index.php?topic=57867.msg2749457#msg2749457", "created_by": "Cosmic_Penguin", "created_on": "2026-01-09T18:32:00Z" } ], "net": "2026-01-15T20:10:00Z", "net_precision": { "id": 1, "name": "Minute", "abbrev": "MIN", "description": "The T-0 is accurate to the minute." }, "window_end": "2026-01-15T20:26:00Z", "window_start": "2026-01-15T19:58:00Z", "probability": null, "weather_concerns": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 1021, "url": "https://lldev.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": 24, "consecutive_successful_launches": 0, "successful_launches": 21, "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-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": 8880, "configuration": { "id": 500, "url": "https://lldev.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://lldev.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": 24, "consecutive_successful_launches": 0, "successful_launches": 21, "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-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_cost": null, "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": 6, "consecutive_successful_launches": 6, "successful_launches": 6, "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": 7471, "name": "Tianqi 37-40", "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": 221, "url": "https://lldev.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://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": 24, "total_landing_count": 0 }, "country_code": "CHN", "map_image": "https://thespacedevs-dev.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": [ { "priority": 9, "source": "youtube.com", "publisher": "ThatSpaceDogeGuy", "title": "Watch Ceres-1S Launch Tianqi 37-40 from Haiyang, LIVE!! (Official TSDG Broadcast)", "description": "Credits: TSDG - The Boys / Douyin\n-------------------------------------------------------------\nSubscribe and follow my socials for more content!!!\n▶️ Twitter/X @TestAiden [ThatSpaceDogeGuy]\n▶️ Instagram | ThatSpaceDogeGuy\n▶️ Tiktok | ThatSpaceDogeGuy\n▶️ Twitch | ThatSpaceDogeGuy\n\nReusing my footage is allowed. Unless cropped.\nIncase of cropping my screen [if the TSDG logo is not on the screen] Please put credits or in the description or on screen..", "feature_image": "https://i.ytimg.com/vi/YfYp6Zs6Diw/maxresdefault_live.jpg", "url": "https://www.youtube.com/watch?v=YfYp6Zs6Diw", "type": { "id": 3, "name": "Unofficial Webcast" }, "language": { "id": 1, "name": "English", "code": "en" }, "start_time": "2026-01-15T19:45:47Z", "end_time": "2026-01-15T20:18:49Z" }, { "priority": 10, "source": "youtube.com", "publisher": "International Rocket Launches", "title": "Live: Ceres-1S Flight 6 Launch (No Commentary)", "description": "Footage courtesy of 飞跃天空·DJI/是云朵呀☁️/嗯嗯/海阳融媒/齐鲁镜界·【记录中国】\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/SLI3ImHOIgk/maxresdefault_live.jpg", "url": "https://www.youtube.com/watch?v=SLI3ImHOIgk", "type": { "id": 3, "name": "Unofficial Webcast" }, "language": { "id": 2, "name": "Chinese", "code": "zn" }, "start_time": "2026-01-15T19:05:22Z", "end_time": "2026-01-15T20:13:20Z" } ], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/ceres-1s_image_20230905114324.jpeg", "infographic": null, "program": [], "orbital_launch_attempt_count": 7184, "location_launch_attempt_count": 22, "pad_launch_attempt_count": 7, "agency_launch_attempt_count": 23, "orbital_launch_attempt_count_year": 11, "location_launch_attempt_count_year": 1, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 1, "pad_turnaround": "P113DT12H14M", "mission_patches": [ { "id": 1297, "name": "Ceres-1S Y7 Patch", "priority": 10, "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/mission_patch_images/ceres-1s2520y7_mission_patch_20260115223707.png", "agency": { "id": 1021, "url": "https://lldev.thespacedevs.com/2.2.0/agencies/1021/?format=api", "name": "Galactic Energy", "type": "Commercial" } } ], "type": "detailed" }
