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/0a8bf8c3-9f75-4fe9-a13d-9419eb09f432/?format=api
{ "id": "0a8bf8c3-9f75-4fe9-a13d-9419eb09f432", "url": "https://lldev.thespacedevs.com/2.2.0/launch/0a8bf8c3-9f75-4fe9-a13d-9419eb09f432/?format=api", "slug": "ceres-1s-tianqi-16-18-20", "flightclub_url": null, "r_spacex_api_id": null, "name": "Ceres-1S | Tianqi 16-18 & 20", "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-05-21T09:52:13Z", "updates": [ { "id": 11029, "profile_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/profile_images/ll2_profile_20230311134739.png", "comment": "Unofficial Re-stream by International Rocket Launches has started", "info_url": "https://www.youtube.com/watch?v=61XEkZWxwEU", "created_by": "LL2", "created_on": "2025-05-19T07:04:00Z" }, { "id": 11031, "profile_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Liftoff.", "info_url": "https://weibo.com/l/wblive/p/show/1022:2321325167977472852177", "created_by": "Cosmic_Penguin", "created_on": "2025-05-19T07:39:00Z" }, { "id": 11032, "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/5168047247328166", "created_by": "Cosmic_Penguin", "created_on": "2025-05-19T08:19:00Z" }, { "id": 10988, "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 uncertain.", "info_url": "https://forum.nasaspaceflight.com/index.php?topic=57867.msg2686041#msg2686041", "created_by": "Cosmic_Penguin", "created_on": "2025-05-14T17:21:00Z" } ], "net": "2025-05-19T07:38:00Z", "net_precision": { "id": 1, "name": "Minute", "abbrev": "MIN", "description": "The T-0 is accurate to the minute." }, "window_end": "2025-05-19T07:57:00Z", "window_start": "2025-05-19T07:29: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": 8613, "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": 7205, "name": "Tianqi 16-18 & 20", "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": "International Rocket Launches", "title": "Live: Ceres-1S Tianqi 37 Launch (No Commentary)", "description": "Footage courtesy of SpaceLens/头号公路/海阳融媒/日照游艇租赁中心/DJI大疆日照盛州王府大街授权店\n\n\nInternational Rocket Launches provides commentary-free coverage of select global rocket launches.\n\nFollow @IntRocketLaunch on Twitte...", "feature_image": "https://i.ytimg.com/vi/61XEkZWxwEU/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=61XEkZWxwEU", "type": { "id": 4, "name": "Unofficial Re-stream" }, "language": { "id": 2, "name": "Chinese", "code": "zn" }, "start_time": "2025-05-19T05:30:33Z", "end_time": "2025-05-19T07:45:33Z" }, { "priority": 10, "source": "weibo.com", "publisher": "Weibo", "title": "微博直播", "description": "", "feature_image": null, "url": "https://weibo.com/l/wblive/p/show/1022:2321325167977472852177", "type": { "id": 3, "name": "Unofficial Webcast" }, "language": { "id": 2, "name": "Chinese", "code": "zn" }, "start_time": null, "end_time": null } ], "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": 6958, "location_launch_attempt_count": 16, "pad_launch_attempt_count": 3, "agency_launch_attempt_count": 20, "orbital_launch_attempt_count_year": 109, "location_launch_attempt_count_year": 2, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 4, "pad_turnaround": "P150DT21H20M", "mission_patches": [ { "id": 1125, "name": "Ceres-1S Y5 Patch", "priority": 10, "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/mission_patch_images/ceres-1s2520y5_mission_patch_20250519083512.png", "agency": { "id": 1021, "url": "https://lldev.thespacedevs.com/2.2.0/agencies/1021/?format=api", "name": "Galactic Energy", "type": "Commercial" } } ], "type": "detailed" }
